Wiki-Plattform-Entscheidung

Stand: 2026-05-20

Ergebnis

Für die Lanstyle-Infrastrukturdokumentation ist ein Git-basiertes Markdown-Wiki mit MkDocs/Material die bessere primäre Lösung als Docmost.

Docmost bleibt als kollaborativer Web-Editor brauchbar, ist aber für die typische Pflege durch Codex, Claude Code und OpenCode nicht optimal als Source of Truth.

Frontend für Menschen

MkDocs Material ist das empfohlene Frontend:

• moderne Navigation mit Seitenbaum
• schnelle Volltextsuche im Browser
• Dark/Light Mode
• Codeblöcke mit Copy-Button
• gute Darstellung für Tabellen, Runbooks und Mermaid-Diagramme
• statische HTML-Ausgabe ohne Datenbankabhängigkeit

Damit bleibt Markdown/Git die Quelle der Wahrheit, während Menschen unter wiki.lanstyle.de ein normales, gut lesbares Wiki bekommen.

Begründung

Die Agenten arbeiten am besten mit Dateien und Git:

• Markdown-Dateien können direkt gelesen, geändert, diffed und reviewed werden.
• Git liefert Historie, Branches, Reviews, Rollbacks und Auditierbarkeit.
• Keine Datenbank-internen Editorformate müssen konvertiert werden.
• Inhalte können von OpenCode, Codex, Claude Code, grep, ripgrep und CI/CD ohne API gelesen werden.
• Ein statisches Wiki ist robust, schnell und einfach zu sichern.

Bewertung

Option	Stärken	Schwächen	Eignung
Docmost	moderner Web-Editor, Spaces, Kollaboration	Inhalte liegen primär in PostgreSQL/Editor-JSON; API/MCP für AI-Workflows teils lizenz-/produktabhängig; Git-Workflow indirekt	gut für Menschen, mittel für Agenten
BookStack	stabile UI, gute REST-API	eigene Seitenstruktur, weniger Git-nativ	gut für klassisches Wiki
Wiki.js	viele Integrationen	mehr Betriebsaufwand, Git-Sync je nach Setup komplex	möglich, aber nicht nötig
Gitea Wiki	Git-nativ, sehr einfach	weniger komfortable Suche/Navigation	gut als Minimalvariante
MkDocs Material	Markdown/Git-nativ, schnelle Suche, statisch, sehr gut agentenlesbar	kein Live-Web-Editor, Änderungen laufen über Git/Deploy	beste Wahl für diesen Zweck

Zielarchitektur

• docs/ ist die kanonische Quelle.
• mkdocs.yml definiert Navigation, Theme und Suche.
• Gitea hostet das Repository.
• Ein statischer Webserver oder CI/CD-Job baut das Wiki.
• wiki.lanstyle.de zeigt langfristig auf die gebaute MkDocs-Seite.
• Docmost kann parallel erhalten bleiben, bis alle Inhalte verifiziert sind.

Betriebsmodell

1. Agent oder Admin ändert Markdown in docs/.
2. Änderung wird per Git commit/versioniert.
3. Build erzeugt statische HTML-Seite.
4. Webserver stellt die Seite bereit.

Sicherheitsnotizen

• Keine Secrets in Markdown oder Git.
• Private SSH Keys bleiben lokal.
• Deploy-Key für Wiki-Deploy nur minimal berechtigen.
• Schreibende Automatisierung nur über dedizierte Service-Accounts.
• Docmost nicht löschen, bevor Export/Import und Cutover validiert sind.