Skip to content

NNNN — Title in the form of the decision

NNNN — Title in the form of the decision

Status: Proposed Date: YYYY-MM-DD

Context

What is the problem? What forces and constraints apply? What must a reader know to judge the decision? Link the proposal issue and any v1 ADR it replaces (“v1 ADR NNNN”, on master).

Decision

What do we do? Write it in the active voice: “We use X for Y.”

Consequences

What gets easier? What gets harder? What must follow (migration, docs, tests, standards register)? Say what it costs.

Roads not taken

One entry for each other option that was weighed.

Option A

  • Pros:
  • Cons:
  • Why not:

Option B

  • Pros:
  • Cons:
  • Why not:

View this record on GitHub