さまざまなプログラム マネージャーがさまざまな形式で仕様を記述しているのを見てきました。ほぼすべての人が、独自の仕様書の書き方を持っています。
一方では、プログラマーに与えられた冗長な文書は、プログラマーにいくつかの見落としを引き起こす可能性が高いものです。私は個人的に単語文書の仕様を恐れています...それは私の読書スタイルのせいだと思います...私はいつも物事を速読しているので、重要なポイントを見逃していると思います.
一方、クライアントの 1 人が Excel で作成した革新的な仕様書を目にしたことがあります。彼が仕様を作成するために使用した方法は、Excel でモック アプリケーションを作成し、VBA を使用してそれをモックするというものでした。彼は、ボタンをクリックしたときにフォームがどこに移動するか、またはどのアクションを実行する必要があるか(コメントで)などを行います。
データフォームでは、フォームをセルに表示し、各データ入力セルで、有効な値とは何か、どの検証を実行する必要があるかなどについてコメントします。
このテクニックを使えば、やらなければならないことを見逃す可能性が低くなったと思います。また、開発者の単体テストがはるかに簡単になりました。テスト担当者も、実際に作成する前に「実行」されたシステムをよりよく理解していました。
Visio も画面デザインを行うツールですが、VBA のサポートとその機能を考慮すると、Excel の方が優れていると思います。
これはより一般的な仕様書の書き方になるべきだと思いますか? プロジェクトマネージャー(または仕様を書いている人)の一部に少し余分な作業が必要であることは知っていますが、その見返りは大きいです...私自身、それを使用することで多くの生産性が向上することを確認できました. そして、実際にプログラマーに役立つ仕様のより良い形式があれば。