今日はペアプロしているときから体調がおかしいと感じていたけれど、家に帰ったら体にジンマシンが出てる。やはり... また「アジャイルソフトウェア開発の奥義」からです。 だが、ドキュメントは簡潔で、要を得たものでなければならない。この場合「簡潔」というのは、せいぜい12〜24ページということで、「要を得た」とは、システム設計については包括的な論理的説明のみにとどめ、システムの構造についてはトップレベルについてのみの記述する(sic)、ということだ。 12〜24ページというのが妙にリアルです。 「Martinのドキュメントに関する第一法則」を紹介しよう。 重要で差し迫った必要のあるドキュメント以外は作成しない。 読書会では「重要で差し迫った必要」とはなんだろうという話になりました。私たちにとってはリリースがそれです。書くのはエンドユーザ向けのドキュメント等です。 『アジャイルソフトウェア開発の奥
![2004-11-29](https://cdn-ak-scissors.b.st-hatena.com/image/square/06a15c64ba0ceec233d86d71001ebb29a9dcbf5d/height=288;version=1;width=512/https%3A%2F%2Fcdn.blog.st-hatena.com%2Fimages%2Ftheme%2Fog-image-1500.png)