docs/issues/0020-doc-03-wiki-oberflaeche-entscheiden-docusaurus.md

---
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.
feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`---`
			`type: issue`
			`id: "0020"`
docs: resolve wiki hostname + surface decisions, track the two follow-ups 2026-08-11 12:00:00 +00:00			`status: done`
feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`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).`

docs: resolve wiki hostname + surface decisions, track the two follow-ups 2026-08-11 12:00:00 +00:00			`## 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.`

feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`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.`