Wie bereits in den Artikeln "Docs as Code - Dokumentation mit Asciidoctor" und "Quellcode in AsciiDoc einbinden" vorgestellt, lassen sich mit AsciiDoc und Asciidoctor sehr effektiv Dokumentationen von Software oder DV-Konzepten erstellen. Wie es sich für jede gute Markup-Language oder Programmiersprache gehört, hilft ein entsprechender Editor mit S...

In diesem Artikel möchte ich am Beispiel von Asciidoctor beleuchten, wie eine Alternative zu klassischen Dokumentationswerkzeugen aussehen kann, wie diese funktioniert, und wie sich Dokumentation als Code in den Softwareentwicklungsprozess einbinden lässt. Gerade für agile Projekte kann die kontinuierliche Fortschreibung und Verbesserung der Dokume...

Einer der wichtigsten Faktoren für die Akzeptanz einer neuen Technologie ist ihre Dokumentation. Anhand von (guter) Dokumentation können neue Entwickler erst in die Bibliothek, das Framework oder die Software einsteigen. Fehlende Dokumentation erschwert es nicht nur Neueinsteigern, sondern auch beständigen Nutzern, die Technologie vollständig auszu...