Dangers of Not Capturing Decisions

#113 - Architecture Decision Record (ADR) - Michael Keeling

Topic 6 of 18

Published Nov 14, 2022 · Clip 15:07–17:46 (2:39)

Michael discusses the dangers of not capturing design rationale. Unlike code structure, which can be recreated from the codebase, the thinking behind decisions is impossible to recover. He uses the Chesterton's Fence parable: you can see the fence but not know why it's there. At his fast-growing startup, people have left and no one can explain how the code got to be the way it is, creating appreciation for ADRs.