記録対象:

基本設計書を新規作成した際の初版情報を改訂履歴に記録する。

具体例:

• 版数: 0.1 または 1.0(プロジェクトの版管理ルールに従う)
• 改訂日: ドキュメントを作成した日付
• 改訂者: ドキュメント作成者の氏名
• 変更内容: 「初版作成」または「新規作成」

記録原則:

• タイムリーな記録: ドキュメント作成と同時に改訂履歴を記録し、後回しにしない
• 版番号ルールの確認: プロジェクトで定められた版管理ルール(初版を0.1とするか1.0とするか)を確認して従う
• 作成者の明記: 誰が作成したかを明確にし、後で質問できるようにする

文書化の推奨表現:

• 表形式で記録し、列は「版数」「改訂日」「改訂者」「変更内容」を最低限含める
• 改訂日は年/月/日形式で統一する
• 変更内容は簡潔に記載する

記録対象:

レビューで受けた指摘事項を反映し、ドキュメントを更新した際の改訂情報を記録する。

具体例:

• 版数: 0.2、0.3などマイナーバージョンアップ
• 改訂日: レビュー指摘を反映した日付
• 改訂者: 指摘を反映した担当者の氏名
• 変更内容: 「顧客レビュー指摘事項反映」「社内レビュー指摘事項反映。詳細: [レビュー記録へのリンク]」

記録原則:

• トレーサビリティの確保: レビュー記録や指摘一覧へのリンクを含め、どの指摘に対応したか追跡可能にする
• 変更箇所の明示: 主要な変更内容を簡潔に記載し、詳細は別資料を参照できるようにする
• 版番号の適切な使い分け: 軽微な修正はマイナーバージョン、大きな変更はメジャーバージョンを上げる

文書化の推奨表現:

• 変更内容には「〇〇レビュー指摘事項反映」と記載し、レビュー記録へのリンクを追加
• 複数のレビューを経る場合は、それぞれの反映時に別行で記録

記録対象:

正式な承認を得て、ドキュメントが確定版となった際の改訂情報を記録する。

具体例:

• 版数: 1.0、2.0などメジャーバージョン
• 改訂日: 承認を得た日付
• 改訂者: 最終更新を行った担当者の氏名
• 変更内容: 「最終承認版」「正式版」「顧客承認済み版」

記録原則:

• 承認の明示: 承認を得たことを明確に記載し、承認記録へのリンクを含める
• メジャーバージョンの適用: 正式承認版はメジャーバージョン(1.0、2.0など)とする
• 基準版としての位置づけ: この版が以降の変更の基準となることを意識する

文書化の推奨表現:

• 変更内容に「最終承認版」または「正式版(第〇版)」と明記
• 承認者や承認日の情報を含められる場合は追記する

記録対象:

ドキュメントのライフサイクル全体を通じて、すべての変更を継続的に記録する。

具体例:

• 軽微な誤記修正、用語の統一、図の差し替えなども記録対象
• 版数は変更の規模に応じて適切に付与
• 変更理由や背景を簡潔に記載

記録原則:

• すべての変更を記録: 小さな変更も含めてすべて記録し、履歴の完全性を保つ
• 変更理由の明記: なぜ変更したのか(誤記修正、要件変更、技術変更など)を記載
• 最新版の明確化: 現時点での最新版がどれかが一目でわかるようにする

文書化の推奨表現:

• 改訂履歴は時系列順(新しいものが上、または下)に統一して記載
• 変更内容の粒度は、後から見て変更の経緯が理解できる程度に記載