# Architecture decision records
ADRs record a decision and the reasoning behind it, so the next person reading the code knows why it is the way it is rather than guessing. One file per decision, named `NNNN-short-title.md` from [`0000-template.md`](0000-template.md).
A decision that came out of an [RFC](../rfcs/) is worth an ADR once it is settled, as is any decision a future contributor would otherwise have to reverse-engineer. Keep them short.
A record is not rewritten when the decision later changes: a new ADR supersedes it, and the old one is marked `Status: Superseded by NNNN`.
## Index