設計用のGitリポジトリを作ったら設計者もレビュワーもハッピーになった話 - WonderPlanet Developers’ Blog

皆さんこんにちは。 ユニバーサルゲーム事業部でサーバーエンジニアをやっております、田口です。 入社して結構な月日が経ち、最近では大規模開発の設計をやる機会が非常に増えたのですが今までの設計のやり方だと分かりづらかったり、レビューしづらかったりと苦しい状況になってきたため思い切って設計専用リポジトリを作ったら色々解決した！という話をさせて頂きます。 元々どのように設計を書いていたか GitHubのIssueに設計を直接書いてました。 設計で書く内容としては以下があり、これらをIssueのコメントで1つずつ記載してました。 概要 DB設計 APIインターフェース設計 機能設計 ログ設計 そしてレビューに出した後、さらにIssueのコメントにレビューを書き、やりとりをしていくわけですが・・・。 これらを続けていくと以下のような状態になってました。 レビューコメントがどんどん増えて長くなるので、I