▼「ドキュメンテーションは、技術(スキル)ではなく、カルチャー(文化)です」
多くの現場では「文章力」や「ツールの使い方」を鍛えようとします。しかし、どれだけ文章が上手い人がいても、チームに「それを読む習慣」や「最新に保つ協力体制」がなければ、情報はすぐに古くなり、死んでしまいます。
ドキュメンテーションの本質は、綺麗な文章を書く技術(スキル)ではありません。 「ドキュメントを『個人の持ち物(宿題)』ではなく『チーム全員の持ち物』と捉え、みんなで一緒に育てていく」という価値観が、チームの文化として根付いているかにあります。
本セッションでは、孤独な作業を「チームの共創活動」へと変革するアプローチを解説します。
◆1.【マインドセット】「孤独」をなくし、共に育てる土壌を作る
■ 質問は「磨き上げ」のプロセス: 読み手の「ここがわかりにくい」という反応は、書き手への批判ではありません。チームの持ち物であるドキュメントを、より使いやすく育てていくための「磨き上げ(改善)」のプロセスです。質問者を「一緒に育ててくれる協力者」と定義し、感謝する空気を作ります。
■ 脱・完璧主義(WIPの運用): 「一人で完成させてから見せる」のではなく、「見出し(骨子)だけでレビューを受ける」プロセスを導入します。30点の状態で共有し、チームの対話によって完成に近づけていくことで、書き手の心理的ハードルを劇的に下げます。
◆2.【仕組み】善意に頼らず、活動を持続させる制度設計
■ 感謝の可視化: 孤独な執筆活動を支えるのはリアクションです。NotionやSlackでの「いいね」やスタンプを徹底し、一方通行ではなく「書く人」と「読む人」が互いに反応し合うエコシステムを構築します。
■ 「隠れた貢献」のヒーロー化: ドキュメント整備は「見えない雑用(Shadow Work)」になりがちです。最も勇気がいる「0→1で書き出した人(ファーストペンギン)」や、地味な修正を続ける人を可視化し、チーム全体で称賛する仕掛けについて解説します。
講演者プロフィール
田口 昌宏
ゲーム開発の現場で、アジャイル導入やチーム改善に長く取り組んできた。現在は株式会社ArentでEngineering Manager / Agile Coachとして、開発チームの対話や協働、継続的な改善を支える活動に携わっている。CEDECでは開発プロセスやチーム改善に関する講演を行い、CEDEC運営委員も経験。
《講演者からのメッセージ》
ドキュメントを書いても読まれない。更新されず、いつの間にか使われなくなる。そんな経験がある方に向けて、ドキュメントを個人の宿題ではなく、チームで育てる活動に変えていくための考え方と仕組みをお話しします。文章が得意な人を増やす話ではなく、チームの関わり方を変える話です。


