Workshop-Days 2025

Ausgezeichnete Softwaredokumentation mit AsciiDoc und Antora
2025-09-10 , Room 3
Language: Deutsch

Gute Softwaredokumentation ist kein Zufall, sondern das Ergebnis sinnvoller Werkzeuge und klarer Strukturen. In diesem Workshop lernen Sie anhand praktischer Beispiele, wie Sie mit AsciiDoc und Antora eine moderne, versionierte und gut wartbare Dokumentationswebsite erstellen. Sie erfahren, wie Sie Inhalte systematisch aufbauen, mit Code und Diagrammen anreichern und zentral gestalten können – ohne auf umständliche Editoren oder proprietäre Plattformen angewiesen zu sein. Ein kompakter Einstieg in den Docs-as-Code-Ansatz für alle, die dokumentieren wollen wie sie entwickeln: klar, nachvollziehbar und nachhaltig.


Am Vormittag lernen Sie AsciiDoc als vereinfachte Auszeichnungssprache kennen, am Nachmittag Antora als perfekt dazu passenden Dokumentationsgenerator. Durch praktische Übungen können Sie eine Dokumentationswebsite von Grund auf erstellen, die Struktur in Module und Komponenten gliedern, das Aussehen und die Navigation anpassen und effizient mit Versionsverwaltungssystemen zusammenarbeiten. Ziel ist, Ihnen das notwendige Rüstzeug zu geben, um Ihre Dokumentationsprojekte auf das nächste Level zu heben. Begleitet wird all das von lehrreichen Erläuterungen zum organisatorischen Wer, Wie und Was der Softwaredokumentation.

>> Zur Anmeldung

Christian Heitzmann ist zertifizierter Softwareentwickler, Technical Writer und Trainer. Als Inhaber der SimplexaCode AG dokumentiert er Softwarearchitekturen für KMUs und unterstützt sie mit Schulungen in modernen Entwicklungstechnologien.