Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz - Ralf D. Müller

Nimmst du teil?

28 Personen nehmen teil

Teilen:
Bild des Veranstaltungsortes

Details

Die Architekturdokumentation zählt zu den wichtigsten Artefakten eines Softwareprojekts. Leider wird diese nur allzu häufig aus Zeitgründen vernachlässigt und ist oft ein gutes Stück von der Realität entfernt. Eine große Hilfe wäre es, wenn man Architekturdokumentation als Teil vom Quellcode ansehen und mit ähnlichen Mitteln organisieren, refaktorisieren und automatisch veröffentlichen könnte. Genau dies ermöglicht das Open Source Projekt docToolchain [1].

Wir freuen uns daher sehr, dass wir hierzu Ralf D. Müller, den Autor der docToolchain, für einen Vortrag bei uns gewinnen konnten.
In seinem Vortrag “Docs-as-Code, arc42, AsciiDoc, Gradle & Co.” wird er zeigen wie man mit Hilfe der docToolchain sehr effizient eine professionelle Architekturdokumentation erzeugen und verwalten kann.

/Abstract
Der Vortrag zeigt, wie Sie die Qualität Ihrer Dokumentation erhöhen und gleichzeitig den Aufwand zur Pflege reduzieren, indem Sie Ihre Dokumentation genauso wie Ihren Code verwalten und in den Build integrieren.

Anhand des Beispiels einer Architekturdokumentation, zeigt Ralf wie Sie mit dem arc42-Template im AsciiDoc-Format und Gradle als Build-Tool einfach Diagramme in Ihre Dokumentation integrieren, Stakeholderspezifische 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 Sie sogar automatisiert testen.

Zwischendurch bekommen Sie zahlreiche Tipps, wie und wo Sie systematisch den Aufwand für Dokumentation reduzieren können und trotzdem lesbare, verständliche und praxistaugliche Ergebnisse produzieren.

/Bio
Ralf D. Müller arbeitet als Architekt und Entwickler und erlebt täglich die Notwendigkeit effektiver Dokumentation. Er ist erklärter AsciiDoc-Fan und Committer bei arc42 sowie Gründer des docToolchain Projektes.

[1] https://github.com/docToolchain/docToolchain