Matt Pocock: comments are a bad store of codebase why — put decisions in ADRs

mattpocockuk · x · 2026-11-21

Matt Pocock argues that comments are a poor store of the 'why' behind a codebase, and architecture decision records (ADRs) are a better place. Responding to the claim that everything in a system should be challenged, he invokes the Chesterton's fence principle: don't remove a fence until you know why it was put up. He also notes not every piece of code needs an ADR.

Related event: Matt Pocock: Put the 'Why' in ADRs, Not Code Comments(2 posts)→

Original post →

More from coding & agent

coding & agent channel →