第11章：ドキュメント品質の守り方（陳腐化対策/Owner/KPI）

この章で学ぶこと

• 陳腐化は発生する前提で検知手段を設ける
• Owner と期限（棚卸し）で更新を回す
• 量ではなく有用性/更新性の KPI を検討する

この章の成果物（または判断基準）

• 棚卸しルール（期限/Owner/更新）
• 品質KPI案（有用性、更新性、事故削減への寄与）

本文

品質は「書いた直後」ではなく「半年後」に差が出る。運用される文書にするには、Owner と見直し期限が必要。

陳腐化の検知

• 期限（見直し日）
• 変更履歴の空白
• 事故/問い合わせの増加

ありがちな破綻パターン

• ドキュメント孤児（入口がない）
• 手順の腐敗（実行すると失敗する）
• Owner不在（誰も直さない）

具体例（悪い例→良い例）

悪い例

文書はあるが、更新されない
問い合わせが増えても放置

良い例

Owner を決め、見直し期限を設定
問い合わせ/障害を起点に手順を更新
KPI を「更新性/有用性」で見る（量で評価しない）

チェックリスト

• Ownerが明確
• 見直し期限がある
• 入口（README/目次）から辿れる
• 事故/問い合わせを更新に反映している

まとめ

• 陳腐化を前提に、Owner と見直し期限で更新を回す
• KPI は量ではなく、有用性/更新性（問い合わせ/事故削減への寄与）で設計する

次章への接続

• 付録: テンプレ集