Thore Cimbal
5b0714a33a
#0024 decided: axionwiki.lab (development-time). #0020 decided: stay on Docusaurus with Authentik forward-auth, not the last word on the surface. Both closed with the decision recorded. New follow-ups the user asked to keep: 0046 (move the wiki into the ThreadNet Server Suite, M4) and 0047 (re-examine surface alternatives beyond BookStack afterwards, M2). STATUS regenerated; validate, gen_status --check, upstream_drift and pruefe_prosa green.
2.5 KiB
type, id, status, created, milestone, priority, due, area, gitlab_iid, related
| type | id | status | created | milestone | priority | due | area | gitlab_iid | related |
|---|---|---|---|---|---|---|---|---|---|
| issue | 0020 | done | 2026-08-02 | M2 | medium | 2026-08-31 | infrastructure | 20 |
DOC-03: Wiki-Oberfläche entscheiden — Docusaurus oder BookStack
Import aus management#20 (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).
Entscheidung (2026-08-12, sorb)
Docusaurus bleibt — für jetzt. Zugang wird per Authentik-Forward-Auth
eingeschränkt (kein Bereichs-Schutz nötig), Konfiguration vorbereitet in gitops
docs/deployment-guides/09-wiki-forward-auth.md; Hostname axionwiki.lab (#0024).
Bewusst kein Schlussstrich unter die Oberflächenfrage: Die Entscheidung gilt für den Entwicklungs-Zwischenstand. Nach dem Umzug in die ThreadNet Server Suite (#0046) werden Alternativen über BookStack hinaus neu geprüft (#0047) — ADR-0007 bleibt insofern nicht das letzte Wort, sondern der bisherige Stand.
Zwei Varianten stehen nebeneinander, damit an echten Inhalten entschieden wird statt am Reißbrett (ADR-0007):
| Variante | Stand | Repo |
|---|---|---|
| Docusaurus | läuft unter axionwiki.lab |
homelab/wiki |
| BookStack | Stack fertig, noch nicht deployt | homelab/wiki-bookstack |
Die eigentliche Frage ist nicht das Werkzeug, sondern: Soll Dokumentation künftig im Repo entstehen (Commit, Review, Git-Historie) oder im Browser (WYSIWYG, Rechte je Buch, eingebaute Suche)? Mit BookStack entsteht eine zweite Quelle der Wahrheit neben git.lab — das kann richtig sein, muss aber bewusst entschieden werden.
Zum Ausprobieren: BookStack deployen (Anleitung im README, drei Pflicht-Secrets), zwei bis drei Seiten anlegen, beide Oberflächen im Alltag vergleichen. Themes liegen in beiden Wunschfarben bei (Gruvbox Dark und Sunset Boulevard, farbgleich zu den Element-Themes), damit der Vergleich nicht an der Optik hängt.
Verfallsdatum setzen: Doppelter Betrieb ist nur als Vergleich vertretbar. Vorschlag: Entscheidung im ersten Refinement (#17), spätestens Ende August — danach wird die Verliererseite abgeräumt, nicht „für später" behalten.
⚠️ Falls BookStack gewinnt: Backup wird Pflicht (Datenbank!), Anschluss an das Verfahren aus CFGMON-09.