10. Architekturentscheidungen
(engl.: Design Decisions)

Dokumentieren Sie hier alle wesentlichen Entwurfsentscheidungen und deren Gründe! Es gehört zu den Entscheidungen, welche Entwurfsentscheidungen relevant genug für die Dokumentation sind!! (sozusagen eine Meta-Entscheidung...)

Es ist wünschenswert, alle wichtigen Entwurfsentscheidungen geschlossen nachlesen zu können. Wägen Sie ab, inwiefern Entwurfsentscheidungen hier zentral dokumentiert werden sollen oder wo eine lokale Beschreibung (z.B in der Whitebox-Sicht von Bausteinen) sinnvoller ist. Vermeiden Sie auf jeden Fall redundante Texte.

Als Form wählen Sie meist eine informelle Liste, möglichst nach Wichtigkeit und Tragweite der Entscheidungen für den Leser aufgebaut.
Jede einzelne Entscheidung könnten Sie in folgender Form erläutern (danke an Stefan Zörner für diesen Vorschlag!):

Fragestellung
Was genau ist das Problem?
Warum ist es für die Architektur relevant?
Welche Auswirkung hat die Entscheidung?

Rahmenbedingungen
Welche festen Randbedingungen haben Sie einzuhalten?
Welche EInflussfaktoren sind zu beachten?

Annahmen
Welche Annahmen haben Sie getroffen?
Welche Annahmen können wie vorab überprüft werden?
Mit welchen Risiken müssen Sie rechnen?

Betrachtete Alternativen
Welche Lösungsoptionen ziehen Sie in die nähere Auswahl?
Wie bewerten Sie jede einzelne?
Welche Optionen schließen Sie bewusst aus?

Entscheidung
Wer (wenn nicht Sie selbst) hat die Entscheidung getroffen?
Wie ist sie begründet?
Wann wurde entschieden?