Skip to main content

ドキュメント運用サイクル — 作成・レビュー・更新

ドキュメント運用サイクル — 作成・レビュー・更新

チームでドキュメントを継続的にメンテナンスするための、作成からレビュー・更新までの運用サイクルです。

運用サイクルの全体像

作成 → レビュー → 公開 → ウォッチ/検証 → 定期更新 → (廃止)
フェーズ 主な活動 関連ナレッジ
作成 テンプレート適用・階層配置 No.4.1, 4.8, 4.10
レビュー コメント・Resolve No.6.1, 6.2
公開 Space 内共有・公開リンク No.6.6, 7.1
鮮度管理 ウォッチ・検証・ラベル No.6.4, 4.9, 7.4
更新 共同編集・履歴復元 No.4.2, 4.6
廃止 ゴミ箱・Obsolete ステータス No.4.7, 4.9

作成フェーズ

  1. Space と階層 を決める(No.5.6)
  2. テンプレート(EE)または親ページの子として新規作成
  3. ラベル(draftreview-needed 等)でステータスを明示
  4. 完成したらレビュアーに共有(メンション or リンク)

レビューフェーズ

  1. レビュアーが インラインコメント で指摘(No.6.1)
  2. 作成者が修正して Reply
  3. 指摘が解消されたら Resolve(EE: No.6.2)
  4. 全スレッド解決後、公開または検証申請

小規模チームではコメントなしで直接編集・ウォッチ通知でレビューする運用もあります。

公開・共有フェーズ

鮮度管理フェーズ

手段 用途
ページウォッチ 更新をチームで追跡
定期検証(Recurring) 30 日ごとなど再確認(EE)
ラベル deprecated 旧版ドキュメントの明示
最終更新日・履歴 いつ誰が更新したかの確認

更新・廃止フェーズ

役割別の責任

役割 運用上の役割
Writer ドラフト作成・更新
Reader フィードバック(コメント)
Space Admin 構成・メンバー・テンプレート管理
Verifier / Approver 検証・承認(EE)

関連ナレッジ