Thore Cimbal
0845af9c44
ADR-0014 records the decision: Wiki.js replaces Docusaurus for the platform wiki — the only option meeting both hard requirements (per-group abschotten AND docs-as-code in git). BookStack ruled out (DB-only, no git). Scope excludes homelab/docs; neckbeard docs stay in management; content in a dedicated wiki repo (not a branch, not a monorepo). ADR-0007 set to superseded. #0047 resolved (decided: Wiki.js). Build issues 0048 (deploy + git storage), 0049 (OIDC + roles/ abschottung: admins write, users read-only), 0050 (theming, colours+logo extracted from homelab/wiki). #0046 becomes the umbrella. STATUS regenerated; all gates green.
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
---
|
|
type: issue
|
|
id: "0047"
|
|
status: done
|
|
created: 2026-08-12
|
|
milestone: M2
|
|
priority: low
|
|
area: infrastructure
|
|
related: [docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md, docs/issues/0020-doc-03-wiki-oberflaeche-entscheiden-docusaurus.md]
|
|
---
|
|
# Wiki-Oberfläche über BookStack hinaus prüfen
|
|
|
|
## Problem / Motivation
|
|
|
|
Die Wiki-Oberfläche wurde bisher nur als **Docusaurus vs. BookStack** betrachtet
|
|
(ADR-0007, #0020). Für den Entwicklungs-Zwischenstand fiel die Entscheidung auf
|
|
Docusaurus mit Forward-Auth. Nach dem Umzug in die ThreadNet Server Suite (#0046)
|
|
soll die Frage aber **breiter** neu aufgemacht werden — nicht nur die alte
|
|
Zwei-Optionen-Wahl, sondern weitere Kandidaten (z. B. Outline, Wiki.js, andere
|
|
docs-as-code- oder App-basierte Lösungen), gemessen an dem, was die Suite dann
|
|
tatsächlich braucht (Bereichs-Rechte? Browser-Editing? Git-Quelle?).
|
|
|
|
## Acceptance
|
|
|
|
- Ein Vergleich mehrerer Kandidaten (nicht nur Docusaurus/BookStack) gegen die
|
|
dann geklärten Anforderungen der ThreadNet Server Suite.
|
|
- Entscheidung als ablösendes ADR (ADR-0007 wird dann `superseded`), falls sich
|
|
etwas anderes als Docusaurus durchsetzt.
|
|
|
|
## Notes
|
|
|
|
Bewusst `low` und ohne Termin: erst nach #0046 sinnvoll, vorher fehlt der Kontext
|
|
(die Anforderungen der Suite). Hängt inhaltlich an #0046.
|
|
|
|
## Entscheidung (2026-08-12, sorb)
|
|
|
|
**Wiki.js.** Es erfüllt als einziges beide harten Kriterien — Abschottung nach
|
|
Gruppe **und** docs-as-code (git-Storage). BookStack scheidet aus (Inhalt nur in
|
|
DB, kein git). Festgehalten in ADR-0014 (löst ADR-0007 ab). Umsetzung über #0046
|
|
und die daraus abgeleiteten Bau-Issues.
|