2005-05-11から1日間の記事一覧

詳細構造についてのドキュメントを先に書く

etc

仕様に関するドキュメントを先に書いてからコードを書くことは普通だろう。では、詳細構造については、ドキュメント先行は行われ得ないのか。fjの教祖様のコメントで、「で、ドキュメントを先にします。」というところがあることから、上記の疑問が浮かんだ…

ドキュメント

etc

「無駄なドキュメントは書くな」 http://d.hatena.ne.jp/hyoshiok/20050510#p1とは言われるものの、では、どういうドキュメントが「無駄」なのか。それをはっきりさせないと、無駄なドキュメントは生成されつづける。上記エントリには、 Martin Fowler氏の「…