ユーザ用ツール

サイト用ツール


it技術:システム開発:設計書作成

差分

このページの2つのバージョン間の差分を表示します。

この比較画面へのリンク

両方とも前のリビジョン前のリビジョン
次のリビジョン
前のリビジョン
it技術:システム開発:設計書作成 [2017/03/08 19:35] yajuadminit技術:システム開発:設計書作成 [2017/03/18 23:52] (現在) – [参照:設計に関すること] yajuadmin
行 1: 行 1:
-====== 意図が伝わる 設計書の作り方 ======+====== 設計書の作り方 ======
  
 日経SYSTEMSを定期購読しているのですが、2007/11号の特集が「意図が伝わる 設計書の作り方」でした。 日経SYSTEMSを定期購読しているのですが、2007/11号の特集が「意図が伝わる 設計書の作り方」でした。
  
-===== 1.想定外の解釈はむしろ当然一つの誤解が手戻りを招く ===== +===== 1.想定外の解釈はむしろ当然一つの誤解が手戻りを招く ===== 
   * "行間"はいらない、価値ある情報もノイズに   * "行間"はいらない、価値ある情報もノイズに
-  * こんな設計書はいらない 点 \\  1. 全体像が分からない \\ 2. 標準が書かれていない \\ 3. 設計変更の理由がどこにもない+  * こんな設計書はいらない 3点 \\  1. 全体像が分からない \\ 2. 標準が書かれていない \\ 3. 設計変更の理由がどこにもない
  
-===== 2.読み手を混乱させる元凶は情報の不足、余計な内容、表現のミス =====+===== 2.読み手を混乱させる元凶は情報の不足、余計な内容、表現のミス =====
   * 情報の不足対策 \\ クラス図の表記法を守る、擬似コードまで記述する、読み手ごとに不足を確認する   * 情報の不足対策 \\ クラス図の表記法を守る、擬似コードまで記述する、読み手ごとに不足を確認する
   * 余計な内容対策 \\ 読み手に必要な情報のみ記述する、図や表を使って単語で表現する \\ 運用設計を1カ所に切り出す   * 余計な内容対策 \\ 読み手に必要な情報のみ記述する、図や表を使って単語で表現する \\ 運用設計を1カ所に切り出す
   * 表現のミス対策 \\ 「ローマ字」や「以上」を使わない、場面ごとに「標準」を示す、\\ 用語集以外の単語を使わせない   * 表現のミス対策 \\ 「ローマ字」や「以上」を使わない、場面ごとに「標準」を示す、\\ 用語集以外の単語を使わせない
  
-===== 3.機能要件設計書だけで20種類役割を知り、書き方をつかむ =====+===== 3.機能要件設計書だけで20種類役割を知り、書き方をつかむ =====
   * 画面設計 \\ 画面の構造は物理的・論理的に示す   * 画面設計 \\ 画面の構造は物理的・論理的に示す
   * 業務プロセス \\ シナリオにボタン名やタブ名を書かない   * 業務プロセス \\ シナリオにボタン名やタブ名を書かない
行 18: 行 18:
  
 ===== 参照:設計に関すること ===== ===== 参照:設計に関すること =====
 +  * [[http://www.ipa.go.jp/sec/softwareengineering/reports/20080710.html|発注者ビューガイドライン]]
   * [[http://itpro.nikkeibp.co.jp/article/COLUMN/20060829/246616/|意図が伝わる設計書作成の心得【第4回】]]   * [[http://itpro.nikkeibp.co.jp/article/COLUMN/20060829/246616/|意図が伝わる設計書作成の心得【第4回】]]
   * [[http://www.st.rim.or.jp/~k-kazuma/SD/SD611.html|設計とは何かを正しく理解する]]   * [[http://www.st.rim.or.jp/~k-kazuma/SD/SD611.html|設計とは何かを正しく理解する]]
行 25: 行 26:
   * [[http://satoshi.blogs.com/life/2004/09/post.html|日本語とオブジェクト指向]]   * [[http://satoshi.blogs.com/life/2004/09/post.html|日本語とオブジェクト指向]]
   * [[http://www.thinkit.co.jp/free/project/4/7/1.html|結合テストと総合テスト]]   * [[http://www.thinkit.co.jp/free/project/4/7/1.html|結合テストと総合テスト]]
 +
it技術/システム開発/設計書作成.1488969353.txt.gz · 最終更新: 2017/03/08 19:35 by yajuadmin