2

さまざまなプログラム マネージャーがさまざまな形式で仕様を記述しているのを見てきました。ほぼすべての人が、独自の仕様書の書き方を持っています。

一方では、プログラマーに与えられた冗長な文書は、プログラマーにいくつかの見落としを引き起こす可能性が高いものです。私は個人的に単語文書の仕様を恐れています...それは私の読書スタイルのせいだと思います...私はいつも物事を速読しているので、重要なポイントを見逃していると思います.

一方、クライアントの 1 人が Excel で作成した革新的な仕様書を目にしたことがあります。彼が仕様を作成するために使用した方法は、Excel でモック アプリケーションを作成し、VBA を使用してそれをモックするというものでした。彼は、ボタンをクリックしたときにフォームがどこに移動するか、またはどのアクションを実行する必要があるか(コメントで)などを行います。

データフォームでは、フォームをセルに表示し、各データ入力セルで、有効な値とは何か、どの検証を実行する必要があるかなどについてコメントします。

このテクニックを使えば、やらなければならないことを見逃す可能性が低くなったと思います。また、開発者の単体テストがはるかに簡単になりました。テスト担当者も、実際に作成する前に「実行」されたシステムをよりよく理解していました。

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

これはより一般的な仕様書の書き方になるべきだと思いますか? プロジェクトマネージャー(または仕様を書いている人)の一部に少し余分な作業が必要であることは知っていますが、その見返りは大きいです...私自身、それを使用することで多くの生産性が向上することを確認できました. そして、実際にプログラマーに役立つ仕様のより良い形式があれば。

4

4 に答える 4

5

Joel on Softwareは特にこれらが得意で、このテーマに関する優れた記事がいくつかあります...

特定のケース

于 2008-08-22T18:22:44.057 に答える
3

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

1つは、質問で説明した「実用的なプロトタイプ」です。私の経験では、会社は完全に機能するHTMLモックを作成するためにユーザーインターフェイスの専門家と契約しました。ページ上のデータは静的でしたが、開発者と管理者はサイトの「機能的な」バージョンを表示して操作することができました。あとは、ページの静的データを動的コンテンツに置き換えるだけでした。このプロトタイプは、製品の初期バージョンの仕様でした。設計者は、モックリンクにカーソルを合わせたときに表示されるポップアップダイアログに、いくつかの微妙な動作の詳細な説明を含めました。それは私たちのチームにとってうまくいきました。

その後のプロジェクトでは、UIエキスパートのような贅沢はありませんでしたが、同様のアプローチを使用しました。ウィキを使用して、サイトのバージョンをモックしました。システムの機能面間のリンクを作成し、各機能を詳細に文書化しました。次に、各機能は、詳細な設計とアーキテクチャの決定にリンクする可能性があります。また、ウィキを使用して、各リリースの機能リストを一覧表示していました(これがリリースノートになりました)。これらのドキュメントは、詳細な機能ページにリンクされています。ウィキは生きたドキュメントになりました-私たちのリリースと私たちのシステムの進化を非常に詳細に説明しています。それはかけがえのないリソースでした。

私は、実用的なプロトタイプよりもwikiの方が好きです。なぜなら、それはより簡単に拡張可能であり、システムが進化するにつれて成長し、より価値のあるものになるからです。

于 2008-09-02T18:48:07.043 に答える
2

実行可能な仕様を作成する手法であるテスト駆動要件についてご覧になったことがあると思います。

その目的のために、 FITFitnesseGreenPepperConcordionなどの優れたツールがいくつかあります。

于 2008-08-29T08:49:26.170 に答える
0

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

また、私の意見では、仕様にはコードを含めないでください。テキストと図を使用して、システムが実行する必要があること、実行する必要があること、実行できないことに焦点を当てる必要があります。

于 2008-08-22T18:22:31.250 に答える