ひょっとして docstring と doctest、あまり浸透してない? | site-hhsPython 使いにとっては空気のようなもの、と思い込んでたし、ワタシが同僚に Python を伝えるなら、かなり真っ先に教えるものなので、ちょっとわかってないのかしら、という記事を見つけてしまってヘコむ。 Sphinxは、Doxygenや javadoc、perldoc などの「コメントからドキュメントを自動生成するツール」ではない。本来。あくまでも「ドキュメントを作るツール」ね。まずは。そして、Doxygenのように使うことも出来る。これが sphinx-apidoc ね。けどこれはあくまでもオカズ。主食じゃないです。 名言されてはいないけれど、ワタシはSphinxが目指すことには一つには「Doxygen的自動生成ドキュメントへの反旗」があるんじゃないかと思っている。確かに「コードからドキュメント自動生成」は、開発者の手間だけは減らせるけれど、わたしがみるに、9割の「Doxygen的ド
