Ich habe im Zuge der Aktualisierung der Dokumentation für meinen Static Site Generator dessen Dokumentation wie auch die für dWb+ und Aviator unter der bekannten Lizenz als Open Source zur Verfügung gestellt.

Für die sQLshell habe ich mich bei Projektbeginn für JavaHelp als Dokumentationsmedium entschieden - das wird sich auch nicht ändern.

Danach stieß ich auf DocBook und habe seither größere Dokumentationen immer damit erstellt. Ich bin zwar erfreut über die Vielseitigkeit von Markdown und werde auch wo immer es geboten ist weiterhin TeX einsetzen - aber für die Erstellung größerer Dokumentationen ist nach wie vor DocBook mein Mittel der Wahl.

Daher überlegte ich neulich (und wegen der Tatsache, dass mir die Erstellung der Dokumentationen aus den DocBook-Quellen mittels ANT schon immer ein wenig sperrig und unhandlich erschien), ob es nicht ein entsprechendes Maven-Plugin gäbe, das diese Aufgabe eventuell mit weniger Schmerzen erledigen könnte.

Nach kurzer Suche stieß ich auf docbkx, das alle meine Erwartungen übertraf.

Dadurch wurde mein Entschluss bestärkt, die bestehenden Dokumentationen für meinen Static Site Generator dessen Dokumentation wie auch die für dWb+ und Aviator als Open Source Projekte zu veröffentlichen. Die entsprechenden Repositories sind auf Gitlab für die Dokumentation des Static Site Generator wie auch die Dokumentation für dWb+ und die Dokumentation für den Aviator verfügbar.

Artikel, die hierher verlinken