日経SYSTEMSを定期購読しているのですが、2007/11号の特集が「意図が伝わる　設計書の作り方」でした。

• “行間”はいらない、価値ある情報もノイズに
• こんな設計書はいらない　3点
  1. 全体像が分からない
  2. 標準が書かれていない
  3. 設計変更の理由がどこにもない

• 情報の不足対策
  クラス図の表記法を守る、擬似コードまで記述する、読み手ごとに不足を確認する
• 余計な内容対策
  読み手に必要な情報のみ記述する、図や表を使って単語で表現する
  運用設計を１カ所に切り出す
• 表現のミス対策
  「ローマ字」や「以上」を使わない、場面ごとに「標準」を示す、
  用語集以外の単語を使わせない

• 画面設計
  画面の構造は物理的・論理的に示す
• 業務プロセス
  シナリオにボタン名やタブ名を書かない
• データ設計
  マスタ系と更新系を明確に分ける

• 発注者ビューガイドライン
• 意図が伝わる設計書作成の心得【第4回】
• 設計とは何かを正しく理解する
• 仕様書の書き方
• 仕様書と設計書
• 技術者のための仕様書の読み方と書き方
• 日本語とオブジェクト指向
• 結合テストと総合テスト