Man kann zwar an vielen Stellen nachlesen, wie man Architekturdokumentation strukturiert. Aber auf der Suche nach einer praktikablen Handhabung zur Erstellung und Pflege enden die meisten Versuche in der WYSIWYG-Hölle einer Textverarbeitung oder im tiefen Schlund eines Wikis. In diesem Vortrag wollen wir uns anschauen, wie aufbauend auf bestehenden Tools und Textformaten eine möglichst redundanzfreie Dokumentation erstellt und für verschiedene Zielgruppen in ansprechenden Formaten ausgeliefert werden kann. Es wird dabei um Begriffe wie Continuous Documentation und Documentation as Code gehen.

Anmerkung fürs Programmkomitee:

Mir geht es darum, Entwickler durch diesen Vortrag wieder für das Dokumentieren zu begeistern, in dem ich Tools und Vorgehensweisen vorstelle, die das Schreiben von Dokumentation effizienter machen. Technische (Architektur-) Dokumentieren wird gern vernachlässigt. Ich möchte moderne Methoden und Werkzeuge vorstellen, die das Dokumentieren in den Entwicklungsalltag integriert und so zu vollständigerer und besser wartbaren Dokumentation führt.

Alternative Titel:
* Kontinuierliche Architekturdokumentation im agilen Umfeld
* Softwarearchitektur kontinuierlich und effizient dokumentieren
* Lebendige Architektur-Dokumentation - kontinuierlich und effizient
* Die 7 Sünden der Architekturdokumentation aus Entwicklersicht
* How-to Docs-as-Code for the busy Java developer

Lessons learned:

Wie man schlank und doch effizient dokumentiert
Wie man Dokumentatieren in den Entwicklungsprozess integriert
Wie man Dokumentaiton aktuell hält und regelmässig validiert

Keywords: Documentation as Code, Continuous Documentation, AsciiDoc, PlantUML, jQAssistant, Continuous Integration