Architekturentscheidungen werden häufig und zumeist implizit getroffen. Da eine Dokumentation dieser nur selten erfolgt, existiert Wissen über diese nur in den Köpfen der Entwickler und eine Weitergabe des Wissens ist schwer bis unmöglich. Ein Wildwuchs verschiedener Implementierungsstile und eine Erosion der Architektur ist der logische Schluss.

Am Beispiel wird gezeigt, wie die Arbeit mit Michael Nygards ADRs erfolgreich etabliert werden kann, um Entscheidungen zu dokumentieren, und welche Tools existieren, um deren Umsetzung automatisiert zu prüfen.

Zur Teilnahme benötigt wird ein Laptop mit Google Chrome oder Mozilla Firefox.

Maximale Teilnehmerzahl: 30

Zielpublikum: Softwareentwickler:innen sowie Architektinnen und Architekten mit Nähe zum Code
Voraussetzungen: Erfahrung im Umgang mit einer IDE
Schwierigkeitsgrad: Fortgeschritten

Extended Abstract
Dieser Workshop möchte mit Michael Nygards "Architecture Decision Records" (ADRs) einen leichtgewichtigen Ansatz zur Dokumentation und Kommunikation von Architektur-Eentscheidungen aufzeigen. Am Beispiel soll erläutert werden, wie sich das Treffen und Kommunizieren von Entscheidungen mit ADRs effizient in den Entwicklungsprozess integrieren lassen. Das Hauptaugenmerk liegt dabei insbesondere in dem Nachvollziehbar-Machen der Entscheidungen für alle Entwickler. Es wird gezeigt, wie sich ADRs mit AsciiDoc versioniert und nachvollziehbar im Projekt integrieren lassen, diese zentral allen zur Verfügung gestellt werden können und wie die Einhaltung der Entscheidungen automatisiert geprüft werden kann. Der Workshop basiert auf den Erfahrungen bei verschiedenen Kunden, bei welchen die Dokumentation mittels Architecture Decision Records erfolgreich eingeführt wurde.