python書くなら絶対に使いたい2つのドキュメント生成ツール - Qiita

python、djangoを本格的に勉強し始めて3ヶ月の自分からみて、これは便利だ！！！と思ったドキュメント生成ツールを2つ紹介します！ 各ツールの概要 → djangoでの適用方法の順で記載しています。 検索してもよく上位に記載されている内容ですが、djangoでの適用例として参考いただければ幸いです。 sphinxを使ったdocstringのドキュメンテーション Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。 このツールはもともと、Python のドキュメンテーション用に作られました、今では幅広い言語のプロジェクトでドキュメント作成を容易にするツールとして利用されています。(by 公式サイト) 自分が知ったきっかけはRead the docsというオープンソースコミュニティの