specifications (その2)

今日は、このまえ書いた仕様書のレビュー結果を元に、修正の作業をした。
ドキュメントというのは、その目的をはっきりさせることが重要だと思う。読む人に何を理解してもらいたいのか、どういう内容を記述したものであるのか。何のために作成するのか。そしてその目的が各項を通して統一されているべきだ。
仕様書の作成は面倒な作業だけれど、そんなに嫌いではない。