Blog

Lean-Architektur-Prinzip Nr. 9: Verständlich statt umfassend

Sander van den Berg

Aktualisiert Oktober 22, 2025

4 Minuten

Dies ist der neunte Beitrag in einer Reihe von Blogbeiträgen über die Prinzipien der Lean Architecture. Jeder Beitrag befasst sich mit einem Prinzip. Die Anwendung dieser Prinzipien führt zu einer Architektur (Prozess), die besser mit dem Unternehmen verbunden ist, besser mit Veränderungen umgehen kann und kohärenter ist. Das neunte Prinzip, das wir erörtern, ist "Verständlichkeit vor Vollständigkeit".

Dokumentation ist in der Architektur wichtig. Architektur ist in erster Linie eine langfristige Angelegenheit. Auch wenn bei einer schlanken Architektur der Schwerpunkt darauf liegt, so früh wie möglich einen Mehrwert zu schaffen, bleiben die Ergebnisse unseres Handelns für die Lebensdauer der Architektur selbst bestehen. Diese erstreckt sich in der Regel über Jahre. Wenn wir einen Schritt zurücktreten und über Architektur und Wertschöpfung nachdenken, können wir uns fragen, warum wir Dokumentation schreiben. Das Hauptziel beim Verfassen von Dokumentation ist die Kommunikation. Wir wollen vermitteln, warum wir bestimmte Entscheidungen getroffen haben, warum wir eine bestimmte Infrastruktur standardisiert haben. Wir schreiben Dinge auf, weil wir eines Tages nicht mehr da sein werden, um diese Dinge zu vermitteln! Das Ziel der (Architektur-)Dokumentation ist es, eine Art "organisatorisches Gedächtnis" zu schaffen. Die Dokumentation beschreibt das Wissen, das innerhalb einer Organisation aufbewahrt werden sollte. Der Schwerpunkt der Dokumentation liegt auf der Kommunikation. Bei der Kommunikation geht es darum, eine Botschaft an ein Publikum zu übermitteln. Jedes Publikum hat seine eigene Art der Ansprache. Um eine Dokumentation zu erstellen, die tatsächlich gelesen wird, müssen wir das Publikum berücksichtigen. Die Dokumentation muss für das Zielpublikum verständlich sein, sonst wird sie zu einer TAGRI-Dokumentation (They Aren't Gonna Read It) (Dank anScott Ambler). Für manche Zielgruppen kann es wichtig sein, so umfassend wie möglich zu sein, aber genau wie beim agilen Manifest ziehen wir Verständlichkeit dem Umfang vor. Dokumentation sollte auch gerade gut genug sein, siehe unsere früheren Grundsätze"Just in time, just enough" und"Travel Light". Jedes architektonische Dokument sollte gerade genug Inhalt bieten, um "die Arbeit zu erledigen" und nicht mehr. Der schwierige Teil besteht darin, zu bestimmen, was gut genug ist. Außerdem werden Artefakte mit der Zeit immer weniger"gut genug". Das bedeutet, dass Artefakte auch lebendige Dinge sind, die schrittweise aktualisiert und erweitert werden sollten.In meiner noch nicht allzu fernen Vergangenheit habe ich zum Beispiel in einem Softwareunternehmen gearbeitet, das Spezifikationen für (Software-)Komponenten schrieb. Diese Spezifikationen wurden in einer leicht formalisierten Form der natürlichen Sprache verfasst. Dies führte natürlich zu Unklarheiten, die zu Fragen und neuen Versionen der Spezifikation führten. Um diese mühsame und zeitraubende Rückkopplungsschleife zu vermeiden, wurde beschlossen, neue Spezifikationen unter Verwendung von UML und OCL so formal wie möglich zu erstellen. Dies führte zu sehr detaillierten Spezifikationen, die nahezu mathematisch fundiert und vollständig waren. Diese Spezifikationen waren jedoch für die Verwendung in Ausschreibungen gedacht. Die Zielgruppe der Spezifikationen waren Accountmanager, Businessanalysten und andere geschäftsorientierte Personen. Diese Leute hatten wenig bis gar keine Erfahrung mit der Verwendung und dem Lesen formaler Sprachen, daher war die Spezifikation völlig unbrauchbar. Wäre die Spezifikation verständlich gewesen, wäre die Kommunikation einfacher gewesen. Wie passt das also zu den 3 Cs der Architektur? Dies war der neunte Beitrag in einer Reihe von Blogbeiträgen über die Prinzipien der Lean Architecture, der nächste folgt in etwa einer Woche.

Mehr aus dieser Serie.