18. Pythonのドキュメンテーションには手書きと自動作成と2種類あった。両方とも開発者、ユーザともにメリット、デメリットがある。手書きの方が品質は高いが、メンテナンスは苦痛であるWerkzeug0.2ではこの2つの組み合わせに挑戦した。Docutilsをベースにコードからの自動抽出を追加し、完全にコードとドキュメントの同期が取れるようになった。Georg Brandlはこのツールを書き直し、Sphinxとしてリリースした。これはPython 2.6, 3.0のドキュメントでも使用され、Python以外のプロジェクトもサポートしているこれは今までで最高のドキュメントツールだ。自動相互リンク、索引の作成もサポートしている。拡張APIを使えばさらなる自動化も期待できるTwitterの写真を引用しました
![Erlang and I and Sphinx.](https://cdn-ak-scissors.b.st-hatena.com/image/square/23917cca17044c3e35ef87d20c5a45dbff7b933c/height=288;version=1;width=512/https%3A%2F%2Fcdn.slidesharecdn.com%2Fss_thumbnails%2Ftokyoerlangworkshop5-100827104026-phpapp02-thumbnail.jpg%3Fwidth%3D640%26height%3D640%26fit%3Dbounds)