いいからぜんぶドキュメント化しようぜ by 加納悠史

PHPerKaigi 2025
レギュラートーク(20分)

いいからぜんぶドキュメント化しようぜ

YKanoh65 加納悠史 YKanoh65
7

仕事の内容をドキュメント化することで得られるメリットはたくさんあります。

  • 多数の人に内容を共有できる
  • 言った言わなかったの議論にならない
  • 後から見返して経緯がわかる

しかし、実際にドキュメントに起こそうとすると面倒に感じ、なかなか実行に移せていない人も多いのではないでしょうか?
また、チームメンバがなかなか仕事内容をドキュメントに起こしてくれず、困っているマネージャーもいることでしょう。

たしかに、物事をドキュメントに起こすことは面倒です。
しかし、逆にドキュメントへ起こさないことによってどのような問題が発生するかを知ることができればドキュメントに起こす気になるのではないでしょうか?

この発表では、仕事内容をドキュメントに起こさないことで発生するデメリットの具体例を示し、なぜドキュメント化をする必要があるのかをドキュメント化を避けるメンバ向けに説きます。