Published: Last updated:

RFCs and ADRs

Complex technology decisions are prepared, discussed, and permanently documented asynchronously through Request for Comments (RFCs) and Architectural Decision Records (ADRs).


Core Concept

Instead of deciding in closed meetings, proposals are written down and opened for feedback. This enables the involvement of experts across time zones and team boundaries, and creates a searchable history of architectural decisions.

Application

  • RFC (Request for Comments): For new, larger concepts or technology introductions.
  • ADR (Architectural Decision Record): A concise record of a decision made, including context and consequences.
  • Git-based: RFCs and ADRs are stored as Markdown files directly in the repository.

Related Topics