意思決定は文書化してログを残して欲しい - cateiru's blog

私のいる開発チームは自分が入社する前からある。そのため、異動してしまってすでにチームにいない人が実装したものがたくさんある。 最近、そういった実装に多く悩まされることがある。なぜ実装したかの経緯が残っていないのだ……どういう実装がされているかというのはコードに書かれているので読めばわかる。しかしコード状にどういう経緯で実装されているのかは書いておらず、これによってその実装の必要性が分からないという状態になることがある。 なので、全人類*1はADR*2を書いて欲しい。ドキュメントに経緯を残して欲しい。なんならUMLを書いておいて将来他の人が見た時のことを考慮されてほしいな ちなみに最近の自分はこの経験からとりあえず迷ったら雑にADR書いて頭の中を整理しつつ清書して他メンバーにレビューいただきつつログを残している。 めっちゃ便利なのでおすすめ。あとは雑でもいいのでログを残す努力はしたい。指標と