---
tags:
  - process/sop
---

# Ziel und Zweck

Die Nachverfolgung der Architektur Entscheidungen soll über Architecture Decision Records (ADR) erfolgen.
Die Beschreibung der Erzeugung von ADR ist in den  [[Architektur Entscheidungen#Referenzen|Referenzen]] beschrieben.

Die Erzeugung von ADR mit Hilfe eines Templates ([[process-architectural-decision-record]]) unterstützt.

# Referenzen

- [Gut dokumentiert: Architecture Decision Records](https://www.heise.de/hintergrund/Gut-dokumentiert-Architecture-Decision-Records-4664988.html?seite=all)
- https://github.com/npryce/adr-tools
- https://adr.github.io/
- https://medium.com/olzzio/how-to-create-architectural-decision-records-adrs-and-how-not-to-93b5b4b33080
- https://medium.com/olzzio/how-to-review-architectural-decision-records-adrs-and-how-not-to-2707652db196
- [The Markdown ADR (MADR) Template Explained and Distilled](https://www.ozimmer.ch/practices/2022/11/22/MADRTemplatePrimer.html)

# Weitergehende Informationen

Ausschnitt aus [The Markdown ADR (MADR) Template Explained and Distilled](https://www.ozimmer.ch/practices/2022/11/22/MADRTemplatePrimer.html):
ADRs help you keep **CALM** because they ease AD making and capturing:
- **C**ollaborative content creation is enabled.
- **A**ccountability is supported and unnecessary reconsideration of issues avoided.
- **L**earning opportunities are provided, both for newcomers and for the experienced.
- **M**anagement likes them too because it is used to making and executing decisions.
