Wie Agenturen Doc-Tools 2026 bewerten sollten
Die Tool-Landschaft wirkt voll — trotzdem veralten die meisten Kunden-Docs. Für Beratung und Agentur-Delivery zählen vier Kriterien: Automatisierung (Sync mit Repo, Generierung aus Code/Spec), Developer Experience (Git-Workflow, Setup-Zeit), Anpassung (Branding, Navigation, Hosting) und Wartung (Versionen, Broken Links, Multi-Release).
Kein Tool gewinnt in allen Dimensionen. Die Aufgabe ist Job-to-be-done beim Kunden: API-first, kollaboratives Help Center, volle Kontrolle oder Python-docstring-nativ.
Steve Baka: Tool-Empfehlung immer nach Datenfluss und Team — nicht nach Demo-Design.
Acht relevante Optionen — neutral
ReadMe — API-first, interaktiver Explorer, Nutzungs-Analytics. Stark für externe Developer Experience; weniger Auto für Narrative-Docs; Preis skaliert mit Team.
GitBook — visueller Editor, Git-Sync, Kollaboration für Support/Product. Gut wenn Nicht-Entwickler mit schreiben; begrenzte Code-Automation; Sync bei komplexen Git-Flows fehleranfällig.
Mintlify — moderne Docs-Sites, zunehmend AI/MCP/llms.txt. Automation und Agent-Readiness im Fokus; Richtung breitere Knowledge-Platform.
Docusaurus — React, Open Source, volle Kontrolle. Kein Built-in-Automation; Setup und Deploy beim Team; Versionierung solide.
Spec- und statische Generatoren
Swagger/OpenAPI + Redoc — Standard für API aus Spec; interaktiv bzw. responsive Three-Panel. Limit: API-only, Spec-Pflege separat, wenig Narrative.
MkDocs — leicht, Markdown, Theme-Ökosystem. Python-Projekte und einfache statische Sites; manuelle Updates.
Sphinx — Python-docstrings, reST, Extensions. De-facto in Python-Ökosystem; steilere Lernkurve, klassischere UI.
Fumadocs / Starlight — moderne OSS-Frameworks (Next/Astro); Framework-Wahl wie Docusaurus — ihr baut den Betrieb.
Entscheidungsmatrix für Kunden
Maximale Code-Sync-Automation: GitHub-native Generatoren, Mintlify-Klasse, oder Custom-Pipeline (Change-Detection + LLM) — siehe Doc-Generator.
API-only + Analytics: ReadMe oder OpenAPI-Stack. Nicht-Dev-Autoren: GitBook. Volle Kontrolle / OSS: Docusaurus, Fumadocs, MkDocs. Python-monolith: Sphinx.
Trend 2026: Automation, Git-Integration, agentenlesbare Artefakte (llms.txt, MCP). Tool-Wahl ohne Agent-Schicht ist unvollständig — siehe llms.txt + Negotiation.
Angebots-Checkliste für Agenturen
□ Kunden-Job (API, Help Center, intern) □ Wer schreibt (nur Devs vs. Support) □ Automation vs. Editorial □ Hosting/Region □ Agent-Readiness □ Exit-Kosten (Lock-in).
Empfehlung dokumentieren: gewähltes Tool, verworfene Alternativen, Betriebsaufwand pro Monat — nicht nur Lizenzkosten.
Verknüpfung: Docs-as-Code, Markt-Positionierung.
