成功するドキュメント管理の秘訣:チェックリスト

2024/07/19に公開

初めに

これまで携わってきたプロジェクトにおいて毎回ドキュメント管理がうまくいかずに困ってきました。
使いやすく効果的なドキュメント管理を実現するために、さまざまなプロジェクトがどのような工夫をしているのか、色々な記事を参考にして要点をまとめました。

使いやすいドキュメント管理チェックリスト

✅ ドキュメントを記載する目的を決めている
✅ 鮮度を保つドキュメント(ストック情報)と保たないドキュメント(フロー情報)を定義している
✅ 最新のドキュメントか判断が可能
✅ ドキュメント管理場所を判断するフロー[1]が誰もが見やすいように管理されている
✅ ドキュメントに書く内容・項目が事前に定義されている
✅ ドキュメントのハードルが低い(記述量が少ない、または自動化)
✅ 非エンジニアも参照可能である(必要に応じて)
✅ メンバーでレビューを経由するというプロセスがある

大事な意識

💬 ドキュメントは「価値を生む存在であると同時に、運用負荷も生む存在である」
💬 個人所有から共同所有への意識変換

参考にしたドキュメント管理記事

以下の記事を参考にして、効果的なドキュメント管理のポイントを整理しました

https://kakehashi-dev.hatenablog.com/entry/2023/10/16/100000

https://speakerdeck.com/kosui/immutable-document-model

https://techblog.zozo.com/entry/adr-culture-of-zozofit#ADRの導入

https://qiita.com/fuubit/items/dbb22435202acbe48849

https://speakerdeck.com/toshiblues/yu-siiqing-bao-gasugunishou-niru-ri-wan-zhang-risuginaikai-fa-dokiyumentoguan-li?slide=8

https://inside.dmm.com/articles/software-documentation-challenges/

https://future-architect.github.io/articles/20231101a/

その他

よく使われるドキュメント管理ツール
  1. GitHub Wiki

  2. Confluence

  3. Notion

  4. Backlog

  5. miro

  6. Figma

  7. esa

  8. JIRA

脚注
  1. ドキュメント管理場所を判断するフロー図 ↩︎

Discussion