意図が伝わる設計書作成の心得【第4回】
「仕様書」は，設計者とプログラマをつなぐ重要なコミュニケーション・ツールだ。それゆえ，安易な書き方をすると問題を起こす。よく議論されるのは，「仕様書の内容はどこまで詳しく書くのが適当か？」という点だろう。過剰品質を避け，効率的に書きたいところだが，きちんと意図が伝わることが大前提である。二つの実例を通して，そのキー・ポイントを紹介する。 今回から，題材を「仕様書」に移して設計書作成の心得を紹介していこう。 前回までは，ユーザーからの要望聴取を基に作成する基本設計書を題材として，設計者とユーザーとのコミュニケーションを軸に展開してきた。これに対し，今回から取り上げる「仕様書」は，基本設計書を基にシステムを実装するプログラマやSEに対して，より具体的なシステムの詳細を伝える設計書である（図1）。 このような設計書は「詳細設計書」や「プログラム仕様書」など，様々な名前で呼ばれていることと思う。ま
意図が伝わる設計書作成の心得【第2回】
設計者とユーザーの間では，システムの仕様を巡って「言った，言わない」の泥仕合をすることが少なくない。両者の思惑や認識がすれ違ったまま基本設計書を作ってしまった結果である。困ったことに，これは一見良好なコミュニケーションを確立したと思われる場合にも起こり得る。このテーマに基づき，二つの実例を通して設計書作成の心得を紹介する。 基本設計書は，ユーザーと円滑にコミュニケーションを行うためのツールであり，コミュニケーションの結果を書き留めたものである。 それ故，コミュニケーションがうまくいかないと，基本設計書に残された情報に思わぬ勘違いや間違いが埋め込まれ，これが後々，プロジェクトに大きな危険をもたらす可能性がある（図1）。恐ろしいことに，誤解の種はユーザーや設計者が発した，たった一言でも生じ得る。基本設計書の作成段階においては，とにかくユーザーとのコミュニケーションを重視し，お互いの考えやシステ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
