続 atsushifxの七転八倒

ウツ、発達障害の闘病記とIT関係のつれずれを書いていきます

<a href="http://d.hatena.ne.jp/daxnaya/20041005#p1">ドキュメントはどこですか?</a>

「ドキュメントとかJavaDocとかって無いんですか?」

「無いです」というと、なんとなく悲しい顔をされるのだが、ドキュメントは衛生要因でしかないと思う。なぜなら、昔からの経験で言うと、きっちりとしたドキュメントを見せた後、決まってこう言われるからである。

「さて、ドキュメント見てもよくわからないから実際にソース追いかけたほうが早いですよね」

プログラマーなのでコードで考えるんです。
というか、欲しいのは全体が一発でわかる俯瞰的なドキュメントなんですよね。
細かい機能とか詳しい説明がかいてあるドキュメントを見ても、頭がパンクするだけですもん。
その意味では、最初に欲しいドキュメントは使用説明書やマニュアルだったりするんです。