伝えるなら、かなり真っ先に教えるものなので、ちょっとわかってないのかしら、という記事を見つけてしまってヘコむ。「コメントからドキュメントを自動生成するツール」ではない。「ドキュメントを作るツール」ね。Doxygenのように使うことも出来る。これはあくまでもオカズ。名言されてはいないけれど、ワタシはSphinxが目指すことには一つには「Doxygen的自動生成ドキュメントへの反旗」があるんじゃないかと思っている。確かに「コードからドキュメント自動生成」は、開発者の手間だけは減らせるけれど、わたしがみるに、9割の「Doxygen的ドキュメント」は、利用者目線に全く立ってはおらず、まずほとんどが使いにくい。なんでこうなるかといえば、「リファレンスしか作れない(というよりは作らない)」から。プログラムに対応付くドキュメントしかドキュメントされないなら、そらそーなるわい。(出来ないという話ではなく、開発者はまずほとんどがサボるので、書かないのだ。してしまうような紹介は大変よろしくない、とワタシは思う。ほうがいーぜ、てことにならあね。(ワタシも事実そう思う。