Zugegeben, kaum jemand fällt beim Thema Architekturdokumentation vor Begeisterung vom Stuhl, aber spätestens bei mittelgroßen Systemen geht es nicht mehr ohne.
Obwohl Architekturdokumentation eine wichtige Rolle im Entwicklungsprozess einnimmt, wird sie ganz häufig stiefmütterlich behandelt. In unseren Projekten treffen wir viel häufiger auf tolle Architekturen als auf tolle Architekturdokumentationen. Dabei begegnen uns immer wieder die gleichen Defizite: Überbetonung von technischen Aspekten oder Vermischung von Lauf- und Entwicklungszeitaspekten sind nur einige Beispiele.
In diesem Vortrag berichten wir von unseren Erfahrungen rund um Architekturdokumentation von unterschiedlichsten Systemen und Branchen. Wir fassen 7 Anti-Pattern zusammen und geben Tipps wie jede:r durch einfache Mittel die Architekturdokumentation verbessern kann. Unsere Tipps sind unabhängig vom verwendeten Vorgehen und natürlich auch kombinierbar mit Templates wie arc42.