Docs-as-Code - Anatomie einer smarten Systemdokumentation

Wir zeigen anhand eines (kleinen aber) realen Projekts, wie Sie Schritt für Schritt den Docs-as-Code-Ansatz verwirklichen können. Von Anforderungs- und Architekturdokumentation bis hin zu Developer-Guidelines ist alles einfach, pragmatisch und zum direkten Konsum („wiederverwenden“) geeignet. Sie erleben (live), wie Sie mehrere Dokumentationsartefakte kombinieren können, für verschiedene Zielgruppen unterschiedliche Ausgaben generieren und plattformübergreifend nebenbei noch eine Website für Ihre Doku zaubern können. Neben diversen Good Practices zeigen Ralf und Gernot auch die Probleme und Grenzen einiger Ansätze auf. Format: Viel Demo, wenige Slides, Github-Repository zum selbst ausprobieren.

Datum: 10.12.2019
Uhrzeit: 10:00 - 11:30
Konferenz / Veranstaltung: IT-Tage Frankfurt 2019
Ort: Kongresshaus Kap Europa Messe / Frankfurt am Main, Frankfurt/Main

Speaker:innen

Dr. Gernot Starke Fellow

Gernot Starke – von ganzem Herzen Informatiker und Softwarearchitekt. Nach langem Aufenthalt in Prograland und sporadischen Ausflügen nach Analytistan ist er seit Jahren in Architektionen zu Hause. Als praktizierender Agilist glaubt er an methodisches Vorgehen in der Softwareentwicklung und lebt dieses entsprechend vor. Er ist (Mit-)Gründer als auch Maintainer von arc42 und aim42 – den Open-Source Ansätzen für Architekturdokumentation und -verbesserung. Als INNOQ-Fellow und -Berater ist er in unterschiedlichen Branchen sowohl in kleinen, mittleren wie auch (ziemlich) großen IT-Projekten unterwegs.

Ralf D. Müller

Ralf D. Müller ist ambitionierter Grails-Entwickler und versucht stetig, seine Arbeit weiter zu vereinfachen. Zurzeit beschäftigt er sich insbesondere mit der Verbesserung der ganzheitlichen Dokumentation von Projekten – vor allem mithilfe des arc42-Templates.

Docs-as-Code - Anatomie einer smarten Systemdokumentation

TAGS