Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docs-First: Dokumentationsportale
Übergeordnete Kategorie: Dokumentenerstellung, Wikis und Notebooks
Systeme für thematisch gegliederte Dokumentationswebsites.
Open-Source-Auswahl nach Reifegrad
5 Einträge: für den jeweils beschriebenen Speicherumfang ausgewählt.
Redaktioneller Stand: 27. September 2026; Bewertungskriterien und Grenzen gelten auch hier. Die Rangfolge priorisiert Reife und danach die Passung zum Thema.
| Rang | Software und offizielle Quelle | Lizenz des betrachteten Kerns | Reifegrad | Begründung | Passender Speicherweg und Nachweis |
|---|---|---|---|---|---|
| 1 | Sphinx | BSD-2-Clause | Sehr hoch | Umfangreiches Handbuch und ausgebautes Erweiterungssystem. | Dateien: reStructuredText-/Markdown-Quellen und HTML-Dateien |
| 2 | MkDocs | BSD-2-Clause | Sehr hoch | Etablierter Markdown-Generator mit zentraler Konfiguration. | Dateien: Markdown-Dateien und YAML-Konfiguration |
| 3 | Docusaurus | MIT | Hoch | Dokumentiertes Framework und Sicherheitsrichtlinie. | Dateien: Markdown-/MDX-Dateien |
| 4 | VitePress | MIT | Hoch | Dokumentation, Änderungsverlauf und Vue-Integration. | Dateien: Markdown-Dateien |
| 5 | Starlight | MIT | Hoch | Eigene Dokumentation und Einbindung ins Astro-Projekt. | Dateien: Markdown-/MDX-Dateien |
Einsatz und Abgrenzung
Die beiden etablierten Generatoren stehen vor den stärker komponentenorientierten Frameworks. Interaktivität ist eine zusätzliche Anforderung, kein Reifebeleg.
- Sphinx: Etablierter Standard für modulare Softwareportale mit mehrstufiger Seitenhierarchie und Quellcode-Verlinkung.
- MkDocs: Ermöglicht die rasche Bereitstellung performanter Dokumentationsportale mit vorkonfigurierter Volltextsuche und responsiver Navigationsleiste.
- Docusaurus: Ausgelegt auf umfangreiche Entwicklerportale mit Versionsverwaltung älterer Dokumentationsstände und integrierter Blog-Komponente.
- VitePress: Liefert ein reaktionsschnelles Portal-Layout für quelloffene Werkzeuge mit schneller statischer Vorab-Kompilierung.
- Starlight: Schlankes Dokumentationsportal auf Astro-Basis mit Fokus auf barrierefreie Seitennavigation und minimalen JavaScript-Ballast im Browser.