Erlang and I and Sphinx.18. Pythonのドキュメンテーションには手書きと自動作成と２種類あった。両方とも開発者、ユーザともにメリット、デメリットがある。手書きの方が品質は高いが、メンテナンスは苦痛であるWerkzeug0.2ではこの２つの組み合わせに挑戦した。Docutilsをベースにコードからの自動抽出を追加し、完全にコードとドキュメントの同期が取れるようになった。Georg Brandlはこのツールを書き直し、Sphinxとしてリリースした。これはPython 2.6, 3.0のドキュメントでも使用され、Python以外のプロジェクトもサポートしているこれは今までで最高のドキュメントツールだ。自動相互リンク、索引の作成もサポートしている。拡張APIを使えばさらなる自動化も期待できるTwitterの写真を引用しました
