29 lines
865 B
Markdown
29 lines
865 B
Markdown
# Architecture Decision Records
|
|
|
|
ADRs dokumentieren zentrale Architekturentscheidungen. Sie werden fortlaufend nummeriert.
|
|
|
|
## Verbindliche Struktur
|
|
|
|
Jedes ADR verwendet diese Gliederung:
|
|
|
|
```text
|
|
# ADR NNNN - Titel
|
|
## Status
|
|
## Kontext
|
|
## Entscheidung
|
|
## Begründung
|
|
## Konsequenzen
|
|
```
|
|
|
|
## Abschnitte
|
|
|
|
- `Status`: aktueller Zustand der Entscheidung, zum Beispiel Vorgeschlagen, Akzeptiert, Ersetzt oder Verworfen.
|
|
- `Kontext`: Ausgangslage und Problemstellung.
|
|
- `Entscheidung`: konkret getroffene Architekturentscheidung.
|
|
- `Begründung`: Gründe für die gewählte Lösung.
|
|
- `Konsequenzen`: positive, negative und organisatorische Folgen.
|
|
|
|
## Umgang mit bestehenden ADRs
|
|
|
|
Bereits akzeptierte ADRs werden nicht stillschweigend inhaltlich umgedeutet. Wird eine Entscheidung ersetzt, soll ein neues ADR angelegt und das alte ADR entsprechend referenziert werden.
|