非同期な開発体制を支えるドキュメント文化 by こんぼい

YAPC::Hiroshima 2024
採択
2024/02/10 14:30〜
bitRiver/カナル・ウェブ会場(コスモス)
トーク (20分)

非同期な開発体制を支えるドキュメント文化

Konboi こんぼい Konboi

所属するLaunchable, inc.では日本とUSの双方にメンバーがおり時差や言語から同期的に開発を進める事が難しいため、非同期な開発体制をドキュメンテーションによって支えています。
本発表では、Launchableでどのようなドキュメントが書かれ、運用されているのかを紹介します。 私が書くときに考えている事/気をつけている事も併せて紹介できればと思います。

話すこと

  • なぜドキュメンテーションを大事にしているのか
  • 書かれているドキュメントの種類と運用方法の紹介
  • ドキュメント運用の難しさ
  • 30/60/90 フィードバック
  • etc

深く話さないこと

  • いい文章を書けるようになるための方法
  • 特定のツール/サービスの詳細な使い方