vendkit docs

DR-NNNN — Title

  • Status: proposed | accepted | superseded by DR-MMMM
  • Date: YYYY-MM-DD

Context

What forces are in play; what problem must be decided. Written so a reader with no project history can follow it.

Decision

The decision, in one or two declarative paragraphs.

Alternatives considered

Each rejected alternative with the reason it lost. This section is the DR's main value — keep it honest.

Consequences

What becomes easier, what becomes harder, what obligations this creates (invariants, tests, docs).