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...

Im letzten Blog-Post haben wir die grundlegenden Eigenschaften und Möglichkeiten gesehen, wie eine Software-Dokumentation mit AsciiDoc erstellt werden kann. Jetzt wollen wir uns im Detail anschauen, welche Möglichkeiten AsciiDoc für die Einbindung von Quellcode in die Dokumentation bietet. Für die Einbindung von Quellcode stehen in AsciiDoc mehrere...

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...

Ausgangssituation Vor etwa zwei Jahren hat unser Kunde im Bankenumfeld ein Großprojekt zur Einführung eines neuen Kernbuchungssystems gestartet. Das Altsystem basiert auf einem über Jahrzehnte gewachsenen Hostsystem. Bis zur Einführung des neuen Systems sollten noch viele Monate vergehen. Für eine Endkundenanwendung zur Verwaltung von Vertragsdaten...

In der täglichen Arbeit mit dem Source Code Management Tool Git sind einige Kommandos in der Praxis manchmal etwas "sperrig", weil sie beispielsweise recht lang und damit aufwändig zu tippen sind. Ähnlich wie die Alias-Funktionalität in der Unix-Shell, kann man für die Git-Kommandos aber auch Aliase hinterlegen. Schauen wir uns das am praktischen B...