- Status: Vorschlag | Angenommen | Abgelöst durch ADR-XXXX | Verworfen
- Datum: JJJJ-MM-TT
- Betrifft: welche Crates, Module oder Abläufe
Welche Situation erzwingt eine Entscheidung? Welche Randbedingungen gelten — Zielhardware, vorhandenes Wissen, Fremdsysteme, Zeit? Hier steht das Problem, noch keine Lösung.
Was wird getan. Ein bis drei Sätze, im Aktiv und in der Gegenwart.
Warum diese Option und nicht die anderen. Die Kriterien, die tatsächlich den Ausschlag gegeben haben — nicht die vollständige Liste aller Eigenschaften.
Option A — warum nicht.
Option B — warum nicht.
Dieser Abschnitt ist der wichtigste des ADR. Ein ADR ohne verworfene Alternativen dokumentiert nichts, was man nicht auch am Code sähe.
Positiv: was dadurch leichter wird.
Negativ: was dadurch schwerer wird. Ehrlich — jede Entscheidung kostet etwas.
Zu beachten: woraus Folgearbeit entsteht, was dadurch festgelegt ist.
Woran man erkennt, dass sie nicht mehr trägt. Falls es keinen solchen Auslöser gibt: hinschreiben, dass die Entscheidung als dauerhaft gilt.