Skip to main content

Explanation Template

Type: ExplanationCreated: Team: Platform
published

Overview​

One paragraph — what does this explain, and why does it matter?

Background​

Context the reader needs before the rest makes sense.

The core idea​

The central mental model. Diagrams and analogies belong here.

How it works in practice​

Walk through a typical case, then an edge case.

Trade-offs​

What this model doesn't solve, and where it breaks down.

  • ADRs that shaped this
  • How-tos for acting on it
  • References for lookup