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.
42 lines
2.5 KiB
Markdown
42 lines
2.5 KiB
Markdown
---
|
|
type: issue
|
|
id: "0020"
|
|
status: done
|
|
created: 2026-08-02
|
|
milestone: M2
|
|
priority: medium
|
|
due: 2026-08-31
|
|
area: infrastructure
|
|
gitlab_iid: "20"
|
|
related: []
|
|
---
|
|
# DOC-03: Wiki-Oberfläche entscheiden — Docusaurus oder BookStack
|
|
|
|
> Import aus [management#20](https://git.lab/axion1337.chat/management/-/issues/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](https://git.lab/axion1337.chat/management/-/blob/main/decisions/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md)):
|
|
|
|
| Variante | Stand | Repo |
|
|
|---|---|---|
|
|
| **Docusaurus** | läuft unter `axionwiki.lab` | [homelab/wiki](https://git.lab/homelab/wiki) |
|
|
| **BookStack** | Stack fertig, noch nicht deployt | [homelab/wiki-bookstack](https://git.lab/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.
|