コードがドキュメントだ - Martin Fowler's Bliki (ja)

http://www.martinfowler.com/bliki/CodeAsDocumentation.html アジャイル手法はプログラミングをソフトウェア開発の中心的役割に押し上げた、とよく言われる——ソフトウェア エンジニアリング コミュニティがやってるようなことよりもずっと優秀だよなあ。 プログラミングが中心的役割となったのは、コードをソフトウェア システムにおける「（最）重要なドキュメント」と位置付けたことが理由なんだと思う。 おっと、よく誤解されるので先に反論しておこう。 先ほどの「コードは重要なドキュメントだ」という原則だけど、 「コードが”唯一の”ドキュメントだ」とは言ってない。 「XPではコードがドキュメントだ」とよく耳にするけど、 XPのリーダー達がそんなことを言ってるのは聞いたことがないなあ。 コードを補完するには、他にもドキュメントが必要なんだ。 なぜコードが重

[y_maeyama]

"「コードは重要なドキュメントだ」という原則だけど、 「コードが”唯一の”ドキュメントだ」とは言ってない。"

[yood]

コードと同じ粒度のドキュメントが存在しても、コードを読むのと労力は変わらないならコードを読んだほうが確実。IO資料やAPI仕様は別だけど。

[mas-higa]

"プロのプログラマというのは、チームのために自分のスタイルを曲げる覚悟があるんだ。" コードはドキュメントじゃないってチームもたくさんあるけど?

[onori108]

"コードが読みにくいのは、 コードのことを真剣にドキュメントとして扱ってないからじゃないだろうか。" わかる。

[pink_revenge]

“「コードはチームの所有物である」（細切れのコードは個人の所有物であってもだ）。 プロのプログラマというのは、チームのために自分のスタイルを曲げる覚悟があるんだ。 ”

[yhanada00]

俺がガンダムだ。