Schöne Dokumentation – nur mit Text

Das Schreiben von Dokumentation ist ein leidiges Thema: Verschiedene Werkzeuge, die Zusammenarbeit im Team oder die Integration in den Arbeitsalltag hindern uns oft daran, überhaupt damit zu beginnen.

In diesem Tutorial zeige ich Euch den Ansatz, den wir beim iSAQB für die Erstellung unserer Lehrpläne entwickelt haben. Ihr lernt die Grundlagen von asciidoc und asciidoctor kennen und arbeitet Schritt für Schritt an einer Verfeinerung des Erstellungsprozesses. Das Ziel: Am Ende haltet Ihr ein ansprechendes und professionell gestaltetes Dokument in den Händen – und habt das Know-how, Eure eigene Dokumentation effizient zu erstellen.

Das Tutorial richtet sich an alle, die technische Dokumentation einfacher, kollaborativer und effizienter gestalten möchten. Es ist praxisnah und interaktiv – bringt also gerne Eure Fragen und Herausforderungen mit!

Benjamin Wolf

‘@ben@innoq.social

Benjamin Wolf arbeitet als Senior IT Consultant bei INNOQ. Seine Schwerpunkte liegen auf dem Modernisieren von Legacy-Systemen, Architekturdokumentation sowie Architekturberatung und -entwicklung. Dabei richtet er ein besonderes Augenmerk auf die Entwicklungsprozesse und die Einstellung zu Softwarequalität in Teams.

Ben ist Committer im arc42-Projekt, aktives Mitglied im iSAQB e. V. und dort aktuell stellvertretender Vorsitzender des Vereins.