Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Dokumentenerstellung, Wikis und interaktive Dokumente

Ein Handbuch für neue Mitarbeitende braucht eine andere Leseführung als die Referenz einer Programmierschnittstelle. Vor der Werkzeugwahl hilft deshalb eine konkrete Frage: Was soll jemand mit dem fertigen Inhalt tun können?

Vom Anwendungsfall zur Dokumentationsform

Für eine Einarbeitung bietet sich eine feste Kapitelreihenfolge an. Zum Nachschlagen sind kurze, direkt verlinkbare Themenseiten sinnvoll. Wenn das Ergebnis von Berechnungen überprüfbar bleiben soll, können Notebooks Text, Code und Ausgabe zusammenhalten. In einem Wiki können mehrere Menschen Begriffe, Erfahrungen und Entscheidungen über Seitenverweise verbinden.

Diese Formen lassen sich kombinieren. Ein Projekt kann ein Einstiegshandbuch, eine API-Referenz und eine Sammlung von Betriebsnotizen pflegen. Entscheidend ist, wo Änderungen vorgenommen werden und wer ihre fachliche Prüfung übernimmt. Ein zusätzliches Such- oder RAG-System erschließt den Bestand, ersetzt seine Pflege aber nicht. Automatisch erzeugte Antworten können fehlerhaft sein.

Beispiel: Betriebsanleitung für einen Dienst

Eine neue Konfigurationsoption erhält eine Referenzseite mit zulässigen Werten. Das Einstiegskapitel zeigt einen typischen Einsatz. Ein Notebook kann eine Messung dokumentieren. Alle drei verweisen auf denselben Versionsstand. So entsteht ein zusammenhängender Bestand, ohne denselben Erklärungstext in mehreren Kapiteln unabhängig pflegen zu müssen.

Unterkategorien: gefilterte Softwareauswahl

Open-Source-Auswahl nach Reifegrad

5 Einträge: für den jeweils beschriebenen Speicherumfang ausgewählt.

Redaktioneller Stand: 27. September 2026. Auswahl nach der gemeinsamen Bewertungsmethode. Die Reihenfolge priorisiert Reife und anschließend die Eignung für diese Kategorie.

RangSoftwareLizenz des KernsReifegradSchwerpunktPassender Speicherweg und Nachweis
1SphinxBSD-2-ClauseSehr hochHandbücher und technische ReferenzenDateien: reStructuredText-/Markdown-Quellen und HTML-Dateien
2PandocGPL-2.0-or-laterSehr hochDokumentkonvertierung und VeröffentlichungDateien: Markup- und Dokumentdateien
3DoxygenGPL-2.0Sehr hochQuellcode- und API-DokumentationDateien: Quellcode-/Textdateien und generierte Referenzen
4JupyterLabBSD-3-ClauseSehr hochInteraktive NotebooksDateien: Notebook-Dateien (.ipynb)
5mdBookMPL-2.0HochMarkdown-BücherDateien: Markdown- und HTML-Dateien

1. Sphinx

Begründung: Umfangreiche Querverweise, mehrere Ausgabeformate und ein etabliertes Erweiterungssystem.

Einordnung: Erweiterungen und Ausgabeformate erhöhen den Konfigurationsaufwand.

Offizielle Grundlage: Sphinx.

2. Pandoc

Begründung: Breite Formatunterstützung, ausführliches Handbuch und nachvollziehbare Entwicklung.

Einordnung: Konverter; keine gemeinsame Redaktionsoberfläche.

Offizielle Grundlage: Pandoc.

3. Doxygen

Begründung: Langjähriger Einsatz in Softwareprojekten; detailliertes Handbuch und dokumentierte Ausgabeformate.

Einordnung: Schwerpunkt auf Quellcode; redaktionelle Inhalte brauchen zusätzliche Struktur.

Offizielle Grundlage: Doxygen.

4. JupyterLab

Begründung: Etabliertes Notebook-Ökosystem mit Dokumentation, Erweiterungen und Gemeinschaftsstrukturen.

Einordnung: Reproduzierbare Ausführung hängt zusätzlich von Kerneln und Abhängigkeiten ab.

Offizielle Grundlage: JupyterLab.

5. mdBook

Begründung: Fokussierter Buchgenerator mit eigenem Benutzerhandbuch, Änderungsverlauf und überschaubarer Struktur.

Einordnung: Für komplexe Publikationsformate sind zusätzliche Werkzeuge nötig.

Offizielle Grundlage: mdBook.