生産性の高いスペックを書くには？

Question

さまざまなプログラム管理者が異なるフォーマットで仕様書を書いているのを見ました。ほぼすべての人が仕様書を書く独自のスタイルを持っています。

一方では、プログラマに与えられた言葉のある文書は、彼/彼女がいくつかの行方不明を引き起こす可能性があります。私は個人的に言葉の文書スペックを恐れている...私はそれが私の読書のスタイルのためだと思う...私はいつもスピードを読んで、私がキーポイントを逃してしまうと思うものを読んでいる。

一方、この革新的な仕様は、私たちのクライアントの1人によってExcelで書かれています。彼が仕様書を書くのに使った方法は、Excelでモックアプリケーションを作成し、それを模擬するためにいくつかのVBAを使用することでした。彼は、ボタンをクリックするとフォームがどこに行かなければならないのか、どのアクションを（コメントの中で）実行すべきかといったようなことを行います。

データフォームで

、彼は細胞内でフォームを表示するであろうし、各データ入力セルに彼がいる有効などの値にコメントだろう、それは私がこの技術を使用して、それがあったことを考えるなど

を何の検証を実行する必要があります実行する必要があることを逃しにくい。また、開発者のために単体テストを行う方がずっと簡単でした。テスターも実際に書かれる前に「実行された」システムのより良い理解を持っていました。

Visioは画面デザインを行うためのもう1つのツールですが、ExcelのVBAサポートとその機能を考慮すると、Excelの方が優れていると思います。

これは仕様書作成の一般的な方法になるはずですか？私はそれがプロジェクトマネージャー（またはスペックを書いている人）の一部で余分な作業をしていることは知っていますが、そのペイオフは巨大です。私はそれを使用することで多くの生産性向上が見えます。そして、実際にプログラマーを助けるより良い仕様書があれば。

Answer 1

Microsoft Pressの書籍の1つに、SRSを含むさまざまなドキュメントの優れた例があります（これはあなたの話です）。それはWeigertの要件の書籍の1つかもしれません（私は彼の名前だと思います、私は今それを空白にしています）。私は米国政府機関がそれをテンプレートとして使用しているのを見てきました。政府との3つの職務経験から、彼らはできる限り自分のものを作りたいと思っています。

また、スペックにはNO CODEが含まれている必要があります。それは、システムが何をすべきか、すべきか、そしてテキストと図を使用して行うことができないことに焦点を当てるべきです。

Answer 2

Joel on Softwareは、私はあなたが実行可能にする技術であるテスト駆動要件について見て、持っているかもしれないと思う...

a specific case

Answer 3

これらに特に良いですし、主題に関するいくつかの良い記事が掲載されています仕様。

FIT,Fitnesse,GreenPepperまたはConcordionのような素晴らしいツールがあります。

Answer 4

2つのアプローチがうまくいきました。

質問に記載されている「作業プロトタイプ」が1つあります。私の経験では、会社は完全に機能的なHTMLモックを作成するためにユーザーインターフェイスの専門家に契約しました。ページ上のデータは静的だったが、開発者と管理者はサイトの「機能的」バージョンで見て遊ぶことができた。ページ上の静的データを動的コンテンツに置き換えるだけでした。このプロトタイプは、当初のバージョンの製品の仕様でした。デザイナーは、モックリンク上でホバリングしたときに現れるポップアップダイアログの微妙な動作の詳細な説明も含めました。私たちのチームにとってはうまくいきました。

次のプロジェクトでは、UIエキスパートの贅沢はありませんでしたが、同様のアプローチを使用しました。私たちはwikiを使ってサイトのバージョンを模擬しました。私たちは、システムの機能面と機能の各部分との間のリンクを作成しました。機能の各部分は、詳細な設計およびアーキテクチャの決定にリンクすることができます。また、Wikiでは、各リリース（リリースノートとなった）の機能リストを掲載するために私たちを保持していました。これらの文書は詳細な機能ページにリンクされています。 wikiは生き生きとしたドキュメントになりました。私たちのシステムのリリースと進化を非常に詳細に記述しています。それは貴重なリソースでした。

あなたのシステムが進化するにつれて成長し、より価値のあるものになるので、私は作業用プロトタイプにwikiが好きです。