Date:  Sat, 27 May 2000 13:05:52 +0900
From:  Kaoru Hosokawa <khosokawa@....com>
Subject:  [XP-jp:00409] Manuals in XP	（ Jeffries 氏のポスト）
To:  extremeprogramming-jp@....jp (extremeprogramming-jp ML)
Message-Id:  <B555786B.18EC%khosokawa@....com>
Posted:  Sat, 27 May 2000 13:05:36 +0900
X-Mail-Count: 00409

ホソカワです。

Jeffries氏のextremeprogramming@....comへのポスト、

    「件名：[XP] Manuals in XP. Formatted. Welcome to the 21st century.」

がおもしろいテーマだったのでお勧めします。

----
「XPでユーザーズガイドをどのように書くか」が提案されています。Jeffries氏の主
張はこのようです。

・分厚いマニュアルを書いてもだれも読まない。
・製品を簡単にしろ。ウェブアプリはマニュアルがない。
・文書化もiterationごとにする。
----

短いサイクルでソフトウェアを書くと同じように、マニュアルも少しづつ、必要な箇
所だけ書く。ライターもXPチームの一員になって、ライターもコードを読んでシステ
ムを理解するのでしょうか？マニュアルも簡単に変更でき、バージョン管理できるシ
ステムで作成するのでしょうね。

-- 
Kaoru Hosokawa
khosokawa@....com