Context
The decision log had the shape of architecture decision records, but an entry could not be cited by number or superseded cleanly, and there was no changelog.
Decision
Each decision is a numbered record (ADR-0001 onward) with a status (proposed, accepted, superseded), context, decision and consequences, one docs page each. A superseded record stays and links its successor; the build checks that both sides of a link agree. Three earlier choices replaced by later records were added after the fact from their commits. The changelog is generated from closed issues and commits, grouped Added, Changed and Fixed.
Consequences
A new decision is a new file with the next number. The changelog needs a network call to GitHub when it is rebuilt. See Decision records.