Gute Softwarearchitektur-Entscheidungen treffen und dokumentieren mit ADRs (Architektur-Decision-Records)

Eine Software-Architektur hat hohe Kosten für Veränderungen, ist oft komplex und tendiert dazu während der Evolution zu erodieren. Ein wichtiger Grund dafür ist sicherlich, dass die zugrundeliegenden Designentscheidungen zwar implizit in der Software-Architektur eingebettet sind, aber wenig bis gar nicht explizit dokumentiert werden. Wenn ihre Software jetzt nicht alle zwei Jahre neu geschrieben wird, sondern mehr als fünf Jahre laufen soll, ist es absolut notwendig alle Architekturentscheidungen gut und nachhaltig, aber trotzdem auch leichtgewichtig zu dokumentieren und zu managen – denn Designentscheidungen müssen nicht für alle Zeiten gelten, sondern können im Lichte neuer Erkenntnisse durchaus revidiert werden und es kommen sicherlich auch immer wieder neue Mitglieder ins DEV-Team, die verstehen wollen warum man sich für eine Designentscheidung entschieden und was die Alternativen dafür waren.

Dieser Vortrag motiviert den Nutzen der expliziten Dokumentation von Architekturentscheidungen mittels ADRs (Architectural Decision Record), zeigt auf was gute von schlechten Architekturentscheidungen unterscheidet, wie der Lebenszyklus einer Architekturentscheidung aussieht und welche Hilfsmittel ihr nutzen könnt, um die Designentscheidungen gut, einfach und nachhaltig zu dokumentieren.