Dokumentation als Code mit Ansible und Asciidoctor

Referierende:

Christoph Stoettner / Homepage

Termin: Sonntag, 10:00 - Raum V1 - Dauer 60 Min.

Die Dokumentation von Software und Umgebungen ist wichtig und erfordert viel Zeit und ständige Anpassungen, wenn sich etwas ändert. In dieser Session lernen Sie, wie Sie Ansible, Jinja2-Templates und Asciidoctor nutzen können, um den Dokumentationsprozess zu automatisieren und trotzdem ansprechende Ergebnisse erzielen zu können.

Mittels Asciidoctor und Pandoc ist auch die Verwendung von Vorlagen und Corporate Identity möglich, und Copy-and-paste in ein Office-Produkt kann umgangen werden.

Diese Session richtet sich an alle, die ihre Dokumentation verbessern möchten.

Nach Abschluss dieser Session werden Sie in der Lage sein,
• die Vorteile der Automatisierung der Dokumentation zu verstehen
• Ansible, Jinja2-Templates und Asciidoctor zu verwenden, um Dokumentation zu erstellen
• Ihre Dokumentation mit diesen Tools und Techniken zu verbessern und zu automatisieren.

Erwünschte Vorkenntnisse: Keine speziellen Voraussetzungen

Material zum Beitrag: Folien (11759 KiB), Weiterführende Informationen (extern)

Video-Aufzeichnung:

Creative Commons Lizenzvertrag Download MP4 (197 MiB)

Video-Aufzeichnung (extern):

https://media.ccc.de/v/clt24-214-dokumentation-als-code-mit-ansible-und-asciidoctor