Latest topics > ドキュメントは善か悪か - outsider reflex

Latest topics > ドキュメントは善か悪か 宣伝。日経LinuxにてLinuxの基礎？を紹介する漫画「シス管系女子」を連載させていただいています。 以下の特設サイトにて、単行本まんがでわかるLinux シス管系女子の試し読みが可能！ « 長音表記 Main 女性との距離感 » ドキュメントは善か悪か - Jul 28, 2008 ある人は、ドキュメントは悪だと言う。毎日のように何かしら変更が加わっていくソースコードの、ある一時点に対してだけの説明を書き記した物であるドキュメントは、あっという間に陳腐化する。Google等で検索すると、すでに陳腐化したドキュメントが山のように引っかかって、正しい情報になかなか辿り着けない。書く者には多大な労力を強いて、利用する者にも無駄な労力を強いる、だからドキュメントは悪なのだという。 僕は、ドキュメントは善だと思っている。ソースコードの読み方

[sett-4]

僕は、ドキュメントは善だと思っている。ソースコードの読み方が分からない、ハチワンダイバー（将棋のマンガ。一歩退いた所から眺めてるだけでは勝てない、9×9＝81マスの将棋盤の中に潜り込むくらいに集中して臨め、

[kits]

「陳腐化したドキュメントであっても、とっかかりくらいにはなる」

[suVene]

id:otsuneさんの言うとおりなんだ。だが、ソース内のコメントに how や what を書いてる人もよくいたり。 「/* a に b を代入 */ a = b;」みたいな。みたらわかるっちゅうねん！

[tarchan]

とっかかりが明後日の方向に向かってるドキュメントに対応してるオレはどうすれば...

[otsune]

コードでhowやwhatは書けてもwhyは表現できません！

[KoshianX]

どちらかというと俺も近い感覚かなあ。とっかかり重要だよなあ