4. Community-Meetup Köln: "Architekturdokumentation aktuell halten"

Wir freuen uns auf ein weiteres Get-Together der Community Köln!
Am 22. Februar lade ich alle Architektur-Interessierten herzlich zu einem weiteren Treffen in Köln ein, zu welchem ich Falk Sippach als Speaker gewinnen konnte. Ich freue mich auf einen regen Austausch, dieses mal mit dem Schwerpunkt Dokumentation vor Architekturen
Agenda
Wir planen folgende Agenda:

• 19:00 bis 19:30 Uhr - Ankommen, Begrüßung, Kennenlernen
• 19:30 bis ca. 20:15 Uhr - Vortrag von Falk Sippach
• ab ca. 20:15 Uhr - Get-Together, Diskussionen (für Drinks & Fingerfood ist gesorgt)

Vortrag von Falk Sippach: "Best Practices um Architekturdokumentation aktuell zu halten"
Eine explizite Softwarearchitektur ist der Garant für erfolgreiche Softwareprojekte. Zur Unterstützung der Kommunikation braucht es eine inhaltlich hinreichende und aktuelle Dokumentation. Der Docs-as-Code-Ansatz unterstützt, in dem die Dokumentation in Form leichtgewichtiger Text- und Grafikformate näher an den Quellcode gebracht, in der Versionsverwaltung abgelegt sowie mit Entwicklerwerkzeugen (IDE/Texteditor, Build-Tools, CI/CD-Pipelines) bearbeitet und in die Softwareentwicklungsprozesse integriert wird.
Der Vortrag stellt einfach anzuwendende Methoden, Vorlagen und Tools vor, die zum Erstellen einer hochwertigen, sich selbst validierenden Softwaredokumentation eingesetzt werden. Wir schauen uns Ansätze wie Docs-as-Code, leichtgewichtige Textformate, Ablage in der Versionsverwaltung und die Einbettung in die Build- und Review-Prozesse an. Das Sichtbarmachen von Softwarearchitekturkonzepten im Code und das Einbinden von Software-Analyse-Werkzeugen ermöglichen den kontinuierlichen Abgleich der Soll- mit den Ist-Strukturen und machen die Architekturdokumentation lebendiger.