Leitlinien für nachhaltige Entscheidungen

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

Wir haben bei unserer Arbeit die folgenden Lehren gezogen, die als Leitlinien und Bewertung zum Erreichen nachhaltiger Entscheidungen dienen können:

Verwenden Sie für die anfängliche Entscheidungsdokumentation einen schlanken/minimalistischen Ansatz.
Priorisieren und erfassen Sie alle wichtigen Entscheidungen, die relevant genug sind, um dokumentiert zu werden und die Zielarchitektur zu verstehen.
Detaillieren Sie die besonders wichtigen Entscheidungen erst mit vollständigen Vorlagen, nachdem die Anfangsarbeit erledigt ist (das heißt, wenn die Entscheider mit den getroffenen Architekturentscheidungen zufrieden sind und zuversichtlich, dass diese Entscheidungen nicht so bald überarbeitet werden müssen).
Verwenden Sie die schlanken/minimalistischen Versionen aus Schritt 1 als Kurzfassung dokumentierter Entscheidungen mit der richtigen Granularität, um einen Überblick über die detaillierten Entscheidungen zu geben, sowie für triviale oder offensichtliche Entscheidungen.
Nutzen Sie wo immer möglich vorhandenes Architekturwissen, entweder aus Leitfadenmodellen oder aus anderen Quellen. Prüfen und erweitern Sie dieses Wissen und passen Sie es an den Kontext der jeweiligen Entscheidung an.
Stellen Sie sicher, dass Rückverfolgbarkeitsverknüpfungen zwischen Entscheidungen und sowohl Anforderungen als auch Architekturentwürfen/Code hergestellt werden.
Sorgen Sie für eine automatisierte Konsistenzprüfung, damit die Rückverfolgbarkeitsverknüpfungen nach einer Änderung synchron bleiben. Begrenzen Sie die Anzahl der Abhängigkeiten zwischen Entscheidungen und anderen Softwareartefakten.
Wenden Sie die Leitlinien für die Begründungen konsequent und nachdrücklich an – sie sind der wichtigste Teil der Entscheidungsdokumentation, weil sie die Begründung liefern.