Architekturdokumentation mit Entwicklerwerkzeugen
Autoren: Stefan Zörner und Peter Götz
Artikel auf JAX enter
online erschienen am 21. Septeber 2015
Wohl jeder kennt die Situation: Ein neues Projekt startet, und diesmal wollen wir alles richtig machen. Wir machen uns erste Gedanken über die Architektur des Systems und schreiben unsere Ideen auf. Wir halten fest, was wir mit welchen Technologien, Mustern, Prinzipien, Konzepten etc. lösen wollen. Dazu verwenden wir Word oder unser Wiki. Am Anfang klappt auch alles super. Die ersten Änderungen, die sich während der Entwicklung ergeben, schaffen es noch in die Dokumentation. Doch je älter das Projekt wird und je größer das Team, desto seltener werden Änderungen an der Architektur in der Dokumentation nachgezogen. So passiert am Ende genau das, was wir vermeiden wollten: Die Dokumentation unserer Architektur spiegelt nicht die Realität wider und keiner weiß so genau, welche Teile noch richtig sind und welche nicht mehr.