docs-as-code

Dieser Vortrag von Ralf Müller zeigt, wie wir die Qualität unserer Dokumentation erhöhen und gleichzeitig den Aufwand zur Pflege reduzieren, indem wir diese genauso wie unseren Code verwalten und in den Build integrieren.

Anhand des Beispiels einer Architekturdokumentation zeigt Ralf, wie wir mit dem arc42-Template im AsciiDoc-Format und Gradle als Build-Tool einfach Diagramme in unsere Dokumentation integrieren, stakeholder-spezifische Dokumente erzeugen und verschiedene Ausgabeformate generieren.

Reviewfähige PDF-Dokumente? Publishing nach Confluence? Integration einer Präsentation? Alles kein Problem! Einige Teile der Doku können wir sogar automatisiert testen!

Zur Java User Group Hessen

Die Java User Group Hessen (JUGH) ist Teil des internationalen Netzwerkes von Java Communities, die sich der weltweiten Verbreitung von Java-Know-how verschrieben haben. Im Sommer 2009 wurde sie von Entwicklern der Micromata GmbH ins Leben gerufen und kann seither auf eine ganze Reihe spannender Workshops und Vorträge zum Thema Java zurückblicken. Die JUGH trifft sich einmal im Monat (in der Regel immer am letzten Donnerstag) in Kassel. Eine Voranmeldung ist meistens nicht nötig, der Eintritt ist frei.

 
Sebastian Hardt

Sebastian Hardt

Scroll to Top