NNNN. Title of the decision

• Status: Proposed | Accepted | Superseded by NNNN
• Date: YYYY-MM-DD

Context

What forces are at play: the problem, the constraints, what makes the choice non-obvious.

Decision

What was decided, stated in full sentences.

Consequences

What becomes easier, what becomes harder, and what must now be kept in mind (with the code that enforces it).

Alternatives considered

The options that were rejected, and why.