Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Architectural decision records

ADRs record important architectural choices and the reasoning available when each choice was made.

Decisions

IDTitleStatus
0001Use fragmented MP4 as the initial media segment formatAccepted

Status values

  • Proposed: under discussion and not yet binding.
  • Accepted: the current direction for implementation.
  • Deprecated: still present but no longer recommended.
  • Superseded: replaced by a later ADR, which must be linked.
  • Rejected: considered and deliberately not selected.

Workflow

  1. Copy template.md to the next zero-padded number.
  2. Describe the context and competing constraints, not only the selected technology.
  3. Record meaningful alternatives and consequences.
  4. Merge an ADR as Proposed or Accepted.
  5. Never rewrite an accepted decision to hide history; add a superseding ADR instead.