要求仕様に書く内容?

質問

ソフトウェアの要求仕様を作成する仕事をしていますが、ハードウェアによる制限や
ソフトウェア側の問題により、特定の条件では仕様を満たせないケースはどういう
風に扱うことが適切なのでしょうか?

たとえば
・要求：「ボタンを押したら画面を表示する。」
・制限： ハードウェアの仕様により、ごく短いボタン押下時間は検出できないことがある。
・制限： ソフトウェアの作りの問題から、ある過渡的な状態では検出できないことがある。
といった状況があったとします。

こういったケースにおいて、ソフト開発者や検査担当者から
「ごく短いボタン押下は検出しない。」、「遷移中は検出しない」という「仕様」を追加して
ほしい、という依頼がきます。(場合によっては、対応が間に合わない部分を「仕様」として
記載してほしい、という要望がくるケースもある。)

しかし、これらの制限は「要求仕様」ではないので、私は要求仕様書に記載する内容では
ないと思うのですが、ではそれ以外のどこで扱うかというと妙案が浮かばない状態です。

こういった内容は一般的に仕様として記載するものなのでしょうか? またそうでない場合、
どういう形で管理すればよいのか、皆様のご意見をいただけないでしょうか?

回答No.2

layy · ベストアンサー

バグの意識も違うようです。

プログラムで画面にでないように仕向けていて、本来出るべきものが出ない、なら話はわかります。

バグとは？。
これも議論です。

いろいろ記述して
仕様書、制限に書いたことと合ってるときもあれば違う時もある、となればやってられないし、それは「仕様書」ではなくなってます。

操作マニュアル
と
"プログラムの"仕様書、
は違います。

お礼

再度の回答ありがとうございます。

「仕様書」と「マニュアル」は違う、という指摘でなんだか見えてきた
ような気がします。仕様書はプログラムの動きを規定するものなので、
それを踏まえて考えればどこまで書くべきかが自ずとわかる、という
ことですね。

あとは関係者と話をしてみます。

回答No.1

layy

「仕様」と「制限」があります。
関係者は取り間違えているような感じがします。

懸念事項がどこに依存しているものかを
明確にすれば、書くべきか書かないべきか、
検討すべき事項か、そうでない事項か、
はっきりするような気がします。

機能仕様書、プログラム仕様書ら「仕様書」は
生産されていくもの、納品するもの、
「仕様書」の位置づけから説明した方がよさそうです。

「ごく短いボタン押下は検出しない。」、
「遷移中は検出しない」、
は書かない。ＳＥの説明で済む話かと思われます。

検査担当者、
どういう基準で"短い"と決めて、
どうやって仕様書記載の検証、動作テストの検証をするのか、
？？？？？？？。

とりあえず、そう感じましたが・・・。

お礼

回答ありがとうございます。やはり仕様書に書く内容ではないですよね。
私もそう主張したのですが、「じゃあどこに書くんだ」と言われて押し
切られてしまいました。

>検査担当者、
>どういう基準で"短い"と決めて、
>どうやって仕様書記載の検証、動作テストの検証をするのか、

これは順番が逆なのです。簡単に言うと、見つけた現象を「バグでない」と
いうためには仕様書に記述が必要、という論理です。

1) テスターがいろいろな押し方を試す。
2) チョン押しをしたときに、画面に表示が出ないのを見つける。
3) バグとして報告があがる。
4) 開発者が調査をするが、ハードの仕様によりキーを検出できていないとわかる。
5) どうしようもないので、「仕様」としてレポートを返却する。
6) テスターが、そんな「仕様」は仕様書にない、としてつき返す。
7) 開発者からどうしようもないので「仕様」に入れてくれ、と依頼がくる。
　 またはテスト担当者から、「仕様であれは、仕様書に追加してくれ」と依頼がくる。
→仕様書に「制限事項」が仕様として追加されていく、という流れです。

回答いただいたように、仕様書の位置づけや役目について話し合ってみたいと
思います。