仕様書

解説

仕様書は、製品がどう動くのが正しいのかを定めた文書です。サポート側が読むのは全体ではなく、問い合わせに出てくる画面や機能の該当箇所だけです。どこを見れば分かるのかと、変更されたときに知らせてもらう経路を開発側と決めておくと、探す時間が減ります。

手元で不具合か仕様かを判定できると回答が速くなる

「不具合なのか、仕様なのか」を判定する基準になります。仕様書にアクセスできないサポートチームは、毎回開発に確認を回すことになり、回答が遅くなります。

仕様書の表現をそのまま伝えても顧客に伝わらない

仕様書は開発者に向けて書かれており、語彙も粒度も顧客向けの説明とは合いません。たとえば「当該フラグが真の場合に限り同期処理が起動する」という記述は、「設定画面で自動更新をオンにしている場合だけ反映されます」と言い換えます。機能名や項目名も、顧客が実際に目にする画面上の表記に置き換えます。