lucille 開発日記: Natural DocsNatural Docs lucille もそろそろドキュメント周りをちゃんとしなくてはと思い、いくつかドキュメントを書くよいツールを探しています。そこで見つけた Natural Docs について。 Natural Docs は、ソースコードに記述されたコメントを解析して、ソースコードリファレンスのドキュメントを作成するツールです。 Natural Docs Doxygen や Javadoc と同じようなものですが、コメントの書き方はそのまま普通に読めるという特徴があります。また生成される HTML のデザインもシンプルで分りやすいです。 Doxygen や Javadoc では、ドキュメント用のコメントは、タグを使って書かなければならないので、なんか普通にソースコードのコメントの記述を見て理解しようとしても、複雑で何がなんだか分らんという欠点があります。コメントに解読が難しいものを書
