# Design decisions that leave a paper trail

Record why a choice won, and when it should stop winning.

ID: adr
Language: en
Revision: 2
Translation source revision: 2
Canonical: https://jujin.dev/en/guides/adr/

## Concept

An architectural decision record (ADR) preserves a significant choice, its context, alternatives, and consequences.

## Example

A public catalog chooses pre-rendered HTML. Cost: rebuild to publish. Revisit if private, personalized content becomes necessary.

## When to choose it

Informal notes are quick but easily lost. ADRs preserve reasoning but need maintenance. Record an owner and status: proposed, accepted, rejected, or superseded. A recommendation is not approval. [AWS](https://docs.aws.amazon.com/prescriptive-guidance/latest/architectural-decision-records/welcome.html)