ドキュメンテーション・シアター ─ 大量に書いて全部死んでいる組織
この記事はAIによって生成されています。内容の正確性は保証されず、記事の利用による損害について一切の責任を負いません。この記事を読み進めることで、利用規約に同意したものとみなされます。
- 想定読者： 文書化文化はあるが活きていない組織のテクニカルライター・ドキュメント担当・EM
- 前提知識： 「組織のコンテキスト供給能力を整える実装ガイド」12パターン D の概要
- 所要時間： 通読 約14分／要点把握 約5分
概要
「文書化文化はある」と公式に主張する組織でも、Wiki の半分以上が18ヶ月以上前で、誤った決定が出る——これは ドキュメンテーション・シアター だ。書く動機があっても 古くする動機がない ため、死んだ文書が累積する。死んだ文書は単に役立たないだけでなく、現役文書より積極的に害を与える：古い情報による誤判断を誘発するからだ。
本記事は、姉妹記事「組織のコンテキスト供給能力を整える実装ガイド」12パターン D を独立記事として深掘りする。ドキュメントのライフサイクル設計（owner / next review / access log / deprecation スプリント）を中心に、生きた文書を維持する仕組みを扱う。
症状：シアター化のサイン
典型的な症状：
- Wiki が10,000ページあるが、半分以上が18ヶ月以上前
- 検索結果の上位に古い情報が並び、最新情報が下位に埋もれる
- 「ドキュメントに書いてある」と言われたが、実際には古くて使えない
- コンプライアンス・監査要件で書かされた文書は最初から読まれていない
- 「文書化したから引き継ぎは大丈夫」と言われたが、後任が読んでも分からない
- ページ数を経営に報告するが、アクセスログは可視化されていない
これらは 量的な文書化文化はあるが、質的に機能していない 状態だ。
メカニズム：書く動機 vs 古くする動機
「古くする動機がない」問題
書く動機は明確：プロジェクト開始、新規施策、コンプラ要件、要請への対応。だが 古くする・廃止する動機は弱い：
- 廃止しても評価されない
- 廃止する決定責任を負いたくない
- 「将来また使うかも」という未練
- 過去の自分の文書を否定する心理的抵抗
- 古い文書を消すことで知識が消える恐れ
結果として、書く方向のフローだけ動き、廃止方向のフローが止まる。10年経つと10年分の死んだ文書が累積する。
「読まれない」問題
死んだ文書は読まれない、だから誰も古さに気付かない。読まれないものは更新されない。これは負のフィードバックループだ：古い → 読まれない → 更新されない → さらに古くなる → さらに読まれない。
コンプライアンス・監査要件で書かされた文書は、最初から読者がいない（監査人だけが読む）。これらは 生まれながらに死んでいる。
死んだ文書の積極的な害
死んだ文書は単に役立たないだけではない。現役文書より害を与える：
- 古い手順を見て従い、現状と齟齬を生む
- 過去の判断を「現在の判断」と誤認して決定が混乱
- 新人が古い情報を学んでしまう
- AI に渡すと誤った文脈で出力が劣化
- 「ドキュメントに書いてある」を盾に変革を拒む
これが ドキュメンテーション・シアターの最大の害 だ。Panopto の調査1 が示すように、組織知識の42%が個人固有で文書化されておらず、書かれた残り58%も古ければ実質ゼロに近づく。書かないより悪い状況になりうる。
対処の方向
1. owner と next review 日付を必須化
各ドキュメントに owner と “next review” 日付 を必須化：
- ドキュメントテンプレに owner（個人ではなく role）と next review date を組み込む
- review されないと自動的に「stale」マークが付く
- stale が3ヶ月続いたら deprecated 候補
これは 書いた瞬間から廃止経路を組み込む 設計だ。F-2 の Goodhart 暴走を避けるため、owner / review を「件数」として KPI 化しないこと。
2. アクセスログの可視化
読まれた回数（access log） を可視化し、低アクセスは廃止候補にする：
- ページごとに「過去90日のアクセス数」を表示
- 月次でアクセス数下位ページのリストを抽出
- 「3ヶ月アクセス数 0」のページは自動的に owner に通知し、廃止 or 更新を求める
これにより、組織は 読まれていない死んだ文書 を構造的に発見できる。
3. Deprecation スプリント
半年に1度、deprecation スプリント を実施：
- 1日〜1週間の集中期間
- 古い／重複／矛盾するドキュメントを統合・削除
- チーム全員が参加（特定の人だけに任せない）
- 削除された文書のリストを公開（透明性）
- 「念のため」で残さない規律
これは reactive な対応ではなく proactive な廃止 だ。書く方向だけ動かすと10年で破綻する。
4. 量の KPI を一切作らない
「ADR 件数」「Wiki ページ数」「postmortem 数」を KPI にしない（F Goodhart 記事参照）。代わりに：
- 参照された回数（access log）
- 再利用された回数（他文書からのリンク数）
- 新人が30日以内にアクセスする回数
これらは 質的な健康度 を測る。量を測ると暴走する。
アンチパターン
| パターン | 何が起きるか | 対処 |
|---|---|---|
| ページ数を経営に報告 | Goodhart 暴走で量だけ増える | アクセスログを報告対象に |
| 「念のため残す」 | 死んだ文書が累積 | 半年棚卸しで明示的廃止 |
| owner を個人に紐付ける | 退職で owner 不明に | owner を role（ポジション）に紐付け |
| Wiki に書けば文書化文化 | 検索性が下がる | テーマ単位の single source of truth（GitLab handbook-first2、Stripe 文書化文化3、Diátaxis 4分類4、Docs Like Code5、Documentation System6 が参考になる） |
| コンプラ要件文書を放置 | 最初から死んでいる | 「読まれない文書は書かない」を経営原則に |
| AI に古い文書を渡す | コンテキスト劣化 | AI 入力前に staleness チェック |
まとめ
- ドキュメンテーション・シアターは「書く動機 vs 古くする動機」の非対称から発生
- 死んだ文書は現役文書より害を与える（誤判断・齟齬・新人の誤学習・AI 劣化）
- 対処：owner と next review 必須化／アクセスログ可視化／半期 deprecation スプリント／量を KPI にしない
- 「読まれない文書は書かない」を経営原則に
- AI 時代は staleness チェックの重要性が増す（古い文書を AI に渡すと出力劣化）
関連記事
- 組織のコンテキスト供給能力を整える実装ガイド ─ 直視から、修復へ - 本記事の親記事
- Goodhart の法則 ─ 文書化を KPI 化した瞬間に空洞化する - 量的 KPI 暴走の構造
- ツール散乱と single source of truth の崩壊 - 検索性とドキュメンテーション
- 「AI が文脈を察してくれる」という誤信 - 古い文書を AI に渡すリスク
参考資料
Inefficient Knowledge Sharing Costs Large Businesses $47 Million Per Year - Panopto + YouGov (2018-07). 【信頼性: 中〜高】 ↩︎
The importance of a handbook-first approach to communication - GitLab Inc. (継続更新). handbook-first 哲学。【信頼性: 高】 ↩︎
From kickoffs to retros and Slack channels — Stripe’s documentation best practices with Brie Wolfson - First Round Review (2023). 【信頼性: 高】 ↩︎
Diátaxis: A systematic framework for technical documentation authoring - Daniele Procida (継続更新). 【信頼性: 中〜高】 ↩︎
Docs Like Code - Anne Gentle (継続更新). コードと同じ運用でドキュメントを管理する哲学。【信頼性: 中〜高】 ↩︎
The Documentation System - Daniele Procida (Diátaxis 前身). 【信頼性: 中〜高】 ↩︎