Es ist die DevOps-Drama-Geschichte des Monats: Das beliebte Doku-Tool MkDocs ist seit Monaten kaum noch gewartet. Jetzt zieht eine Gruppe Community-Mitglieder den Reißbleisten — und gabelt das Projekt unter dem Namen ProperDocs. Drop-in-Replacement, voll kompatibel, mit dem Anspruch, das zu liefern, was viele bei MkDocs schmerzlich vermissen: Tickets schließen, Plugins aktualisieren, Sicherheits-Lücken patchen.
WAS ist passiert bei MkDocs?
Florian Maas hat in seinem Blog »The Slow Collapse of MkDocs« durchgerechnet, wie selten Maintainer-Aktivität in den letzten Quartalen war. Die Diskussionen im offiziellen MkDocs-Repo (»Is MkDocs still maintained?«) zeichnen ein ähnliches Bild: Pull Requests bleiben monatelang liegen, Issues sammeln sich, das letzte Release ist alt. Wenn dein Tooling-Stack auf einem solchen Fundament steht, ist das ein Risiko — egal wie viel du die Software magst.
WIE löst ProperDocs das?
Der Wechsel ist eingedampft auf zwei Befehle:
pip uninstall mkdocs
pip install properdocsStatt mkdocs build rufst du dann properdocs build auf. Bestehende mkdocs.yml-Konfigurationen funktionieren unverändert, weil ProperDocs als 1:1-Drop-in für MkDocs 1.x angetreten ist. Plugins, Themes und Markdown-Erweiterungen laufen ohne Code-Anpassung weiter.
WARUM ist das relevant für dich?
Wenn du in deinem Homelab Doku in MkDocs hostest — ob als statisches Site-Bundle hinter Caddy oder per CI auf Pages — hängt deine Pipeline an einem Pythonpaket, das ein Bus-Faktor-Risiko hat. Bus-Faktor 1 bedeutet: Ein einziger Wegfall des Maintainers reicht, um die Toolchain zu kippen. ProperDocs entkoppelt dich von genau diesem Punkt.
SO machst du den TEST in 10 Minuten
Auf einer Test-Maschine ein frisches Python-Venv hochziehen, ProperDocs installieren, deine vorhandene Doku reinkopieren, properdocs build rufen, das HTML mit dem MkDocs-Output diffen. Wenn keine Differenzen entstehen, ist der Switch trivial. Bei einem produktiven Wechsel würdest du den CI-Befehl umstellen und Dokumentation deiner CI-Pipeline anpassen.
ZUM HINTERGRUND: Bambu Lab, MkDocs, jetzt ProperDocs
Mai 2026 ist ein Monat, in dem die Open-Source-Welt mehrfach Gabel zieht: Bambu Lab hat den Streit um den Cloud-Bypass losgetreten, Mozilla baut den Universal-LLM-API-Layer gegen Vendor-Lock-In, und jetzt formiert sich die nächste Doku-Tool-Community. Das Muster ist klar: Wo Wartung fehlt, organisiert sich die Community.
Quellen: github.com/ProperDocs/properdocs (Repo), fpgmaas.com (Blog), MkDocs Discussion #4010 (Issue).