* 基本事項 [#u393dd30]
** ドキュメンテーションの目的と心得 [#pcc3dd72]
-完璧なドキュメントを書こうとしない。70点で合格。
-ドキュメントの共同所有を進めよう
-ドキュメントは気軽に書こう

** ドキュメンテーションする／しない？ [#y59d0351]
口頭で伝える人的負荷と「書かないリスク」を考える。

** ドキュメントの品質特性 [#m30e3ad9]
-必要十分性 ... 目的を達成するために必要な情報が、過不足なく提供されているか？
-正確性
-- 情報の正確性 ... 情報が誤りなく提供されているか？
-- 表現の正確性 ... 情報が正しく表現されているか？
-わかりやすさ ... 内容が容易に理解できるようになっているか？
-検索しやすさ ... 欲しい情報がすぐに見つかるようになっているか？
-魅力 ... 読む気になるかどうか？
-法規・規約の遵守 ... 著作権を侵害していないか？差別的表現はないか？

* ウォーターフォール・モデルでのドキュメント [#a9f719d5]

| フェーズ | ドキュメント | 説明 |h
| 要件定義 | | |
| 外部設計 | | |
| 内部設計 | システム処理方式設計書 | |
|~| 性能処理方式仕様書 | |
|~| リカバリ・リスタート方式設計書 | |
|~| 運用処理方式設計書 | |
|~| プロセス構造設計書 | |
|~| アプリケーション構造設計書 | |
|~| データ仕様書 | |
|~| 物理アプリケーション・ファイル設計書 | |
| プログラム開発 | | |
| システムテスト&br;・結合テスト | | |
| 保守 | | |
| その他 | | |

* リンク集 [#a591f208]
-[[即活用！業務システムの開発ドキュメント標準化:http://www.thinkit.co.jp/free/project/4/1/1.html]]
トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS