大山ゆっけ(蘇る鈴木佑輔) @trinity_site いろいろなライブラリのドキュメンテーションを見てると、自動生成っぽい割には知ってるツールのリンク構成と違うものが結構ある。知らないツールがまだまだあるのかな。 2011-05-28 13:44:18 大山ゆっけ(蘇る鈴木佑輔) @trinity_site C/C++の場合、最低限の引数の意味などはヘッダに載っていて欲しいものの、概念的な説明などまでヘッダに書くとコードが冗長になる。また、ドキュメントの改訂のためにヘッダに触るのもはばかられる。翻訳の管理まで考えるとドキュメントとヘッダは分離していた方が良い。 2011-05-28 13:47:57
![C++向けドキュメンテーションツールの悩み覚書](https://cdn-ak-scissors.b.st-hatena.com/image/square/ae413683e257cc43e2e5a3acb4d6f31d93ee9c25/height=288;version=1;width=512/https%3A%2F%2Fs.togetter.com%2Fogp2%2Fa0bd6a0ae941e1be6cfa041b979312ac-1200x630.png)