「スラッシュドットに聞け：ソフトウェア開発の現場で設計書は必須か」記事へのコメント

若いのう

[hinatan (24342)]

仕様書はテストケース、サポート向けマニュアル、ユーザ向けヘルプの原材料にもなりますので必ず必要。

あと若いうちは「設計書なんかいらねぇ！」って言えるかもしれませんが、
年取ると（よぼよぼ・・）記憶力が衰えて１年前に自分の作ったものも忘れちゃう。
ヤングでもとある文字列の validation規則なんて聞いても答えられない。

なので仕様書は小さなプロジェクトでもまず「自分のために」書く。

役に立つ仕様書を速やかに書けないというのなら単に能力が不足しているだけで、それを棚に上げて仕様書という道具のせいにしちゃいけない。

Re:

[Anonymous Coward]

そういうレベルの話なの？
設計ってのは、なぜその実装を選んだのか、なぜその状態遷移を選んだのか、なぜそのリレーション構造を選んだのか
といった、要求仕様とコードの間を埋めるものだろ。

validationだったら、個々の項目なんてレベルじゃなくて、HTML5標準でやるよ、とかプラグイン使うよということと、
”なぜ”そうしたのかを書くためのものだろ。

自分は設計書には何をしたかを書いて、コードには何をしていないか（添え字のチェックが緩いとか）を書いている。

Re:若いのう

[hinatan (24342)]

元ネタに「詳細な仕様の共有」とあって、用語定義とその共有が出来てない以上効率のいい議論ができない状況であります。