こんにちは、ギフティでエンジニアをやっている中屋です! 自分は割とドキュメントが好きです。 ドキュメントはなさすぎるよりはありすぎた方がマシと思っている派閥です。 はじめに 我々のチームでは開発ドキュメントとして ADR(Architecture Decision Record)というものを書き残すようにしています。 ADR とは平たく言うと、「設計上の選択を記録したもの」です。システム開発のなんらかの意思決定に対して、その判断理由などを短いテキストファイルにまとめたものを指します。 自分が初めて ADR という言葉を知ったのは『Design It!』という本でした。 最近ではいろんな企業が ADR を書いているのが、ブログ等から伺えます。 ADR そのもの自体の詳しい解説についてはネット上にたくさん情報があるのでここでは割愛します。 参考: https://cloud.google.co
![俺たちはこう ADR(Architecture Decision Record)を書いている | giftee engineer blog](https://cdn-ak-scissors.b.st-hatena.com/image/square/cc03e25d92148bb66561d825fa68cda9fc6c067c/height=288;version=1;width=512/https%3A%2F%2Fblog.giftee.dev%2Fseo%2Fogp.png)