How to write an ADR no one will read (and how to write one they will)

Draft writing — full body publishes via the editorial workflow.

An ADR is a political document pretending to be a technical one. If your ADRs read like minutes — passive voice, no named alternatives, no named losers — nobody will read them, and the decision will quietly drift. This post argues for an opinionated, attributable, slightly uncomfortable style.