ユーザ用ツール

サイト用ツール


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

差分

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

この比較画面へのリンク

両方とも前のリビジョン前のリビジョン
次のリビジョン
前のリビジョン
最新のリビジョン両方とも次のリビジョン
it技術:システム開発:設計書作成 [2017/03/08 19:35] yajuadminit技術:システム開発:設計書作成 [2017/03/18 23:50] – [参照:設計に関すること] 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種類役割を知り、書き方をつかむ =====
   * 画面設計 \\ 画面の構造は物理的・論理的に示す   * 画面設計 \\ 画面の構造は物理的・論理的に示す
   * 業務プロセス \\ シナリオにボタン名やタブ名を書かない   * 業務プロセス \\ シナリオにボタン名やタブ名を書かない
行 22: 行 22:
   * [[http://homepage2.nifty.com/cat-chy/cp/specification.html|仕様書の書き方]]   * [[http://homepage2.nifty.com/cat-chy/cp/specification.html|仕様書の書き方]]
   * [[http://iwatam-server.dyndns.org/software/devintro/deathmarch/deathmarch/x131.html|仕様書と設計書]]   * [[http://iwatam-server.dyndns.org/software/devintro/deathmarch/deathmarch/x131.html|仕様書と設計書]]
 +  * [[http://www.ipa.go.jp/sec/softwareengineering/reports/20080710.html|発注者ビューガイドライン]]
 +  * [[http://www.atmarkit.co.jp/bbs/phpBB/viewtopic.php?topic=45308&forum=25&start=8|基本設計がなっていない]]
   * [[http://www.kaimei.org/note/mag/siyou.html|技術者のための仕様書の読み方と書き方]]   * [[http://www.kaimei.org/note/mag/siyou.html|技術者のための仕様書の読み方と書き方]]
   * [[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技術/システム開発/設計書作成.txt · 最終更新: 2017/03/18 23:52 by yajuadmin