やさしい機能仕様 パート2: 仕様書とはどんなものか? - The Joel on Software Translation Project

Joel Spolsky ジョエル・スポルスキ 翻訳: Yasushi Aoki 青木靖 2000/10/3 (パート1はもう読んだ? 読んでなければ、ここにある。) このアーティクル･シリーズで扱っているのは機能仕様であって、技術仕様ではない。人々はこの2つを混同している。標準的な用語があるのかどうか知らないが、私がこれらの用語を使うときに意味しているのは以下のことだ。 機能仕様書は、ユーザの観点から製品がどのように動くか記述する。それはどのように実装されるかは問題にしない。それは機能を話題としており、画面とか、メニューとか、ダイアログとかいったものの仕様を定める。 技術仕様書は、プログラムの内部の実装について記述する。それはデータ構造、関係データベースモデル、プログラミング言語や開発ツールの選択、アルゴリズムといったものを話題としている。 あなたが製品を隅から隅までデザインするとき、最

[isrc]

私がいつも仕様書に入れているもの／注意書。作成者。シナリオ。対象外。概要。詳細。未解決の問題。傍注／仕様書は生きている必要がある。仕様書はコードコンプリートしたときに初めて、凍結される。

[koriym]

"我々はプログラムをすべて一度にデザインし、仕様書を書き、それを印刷し、壁越しにそれをプログラマに投げ渡して家に帰る。私に言わせると「ハッハッハッ!」だ。"