docs: resolve wiki hostname + surface decisions, track the two follow-ups

#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.
This commit is contained in:
Thore Cimbal
2026-08-11 12:00:00 +00:00
parent 2539fd01e8
commit 5b0714a33a
5 changed files with 95 additions and 6 deletions
@@ -1,7 +1,7 @@
---
type: issue
id: "0020"
status: next
status: done
created: 2026-08-02
milestone: M2
priority: medium
@@ -14,6 +14,17 @@ related: []
> 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 |
@@ -1,7 +1,7 @@
---
type: issue
id: "0024"
status: open
status: done
created: 2026-08-02
milestone: M2
priority: low
@@ -13,4 +13,14 @@ related: []
> Import aus [management#24](https://git.lab/axion1337.chat/management/-/issues/24) (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).
## Entscheidung (2026-08-12, sorb)
**`axionwiki.lab`.** Damit sind `external_host`, der Traefik-`Host()` und der
Cookie-Scope der Forward-Auth-Konfiguration eindeutig festgelegt (gitops
`docs/deployment-guides/09-wiki-forward-auth.md`).
⚠️ Ausdrücklich ein **Entwicklungs-Zwischenstand**: Das Wiki zieht später in die
ThreadNet Server Suite um (#0046), danach wird die Oberfläche über BookStack
hinaus neu bewertet (#0047) — beim Umzug ändert sich der Host erneut.
@@ -0,0 +1,35 @@
---
type: issue
id: "0046"
status: open
created: 2026-08-12
milestone: M4
priority: medium
area: infrastructure
related: [docs/issues/0024-wiki-hostname-klaeren-wiki-lab-oder-axionwiki.md, docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md]
---
# Wiki in die ThreadNet Server Suite umziehen
## Problem / Motivation
Das Wiki läuft aktuell als einzelner Dokploy-Stack auf Overmind
(`axionwiki.lab`) mit Forward-Auth über den Prod-Authentik — ein bewusst
provisorischer Entwicklungs-Zwischenstand (#0024, #0020). Die Vision „reproduzierbar
für Dritte" verlangt aber, dass das Wiki **Teil des reproduzierbaren Stacks** wird,
nicht ein Einzelstück auf dem Lab-Host: Eine forkende Community soll es mit dem Rest
der ThreadNet Server Suite ausrollen können.
## Acceptance
- Das Wiki ist Bestandteil der ThreadNet-Server-Suite-Deployment-Definition
(nicht mehr ein losgelöster Overmind-Stack).
- Host, Reverse-Proxy und Auth-Anbindung sind für die Suite konsistent gelöst —
die Forward-Auth-Verdrahtung aus gitops-Guide 09 wird dabei sauber abgelöst, nicht
fortgeschleppt (sie ist genau darauf ausgelegt).
- Instanzwerte (Host, Auth-Client) sind von generischer Struktur getrennt, damit
ein Fork sie ohne Code-Änderung setzen kann.
## Notes
Beim Umzug ändert sich der Host erneut — der `axionwiki.lab`-Stand aus #0024 gilt
nur bis dahin. Erst nach diesem Umzug greift #0047 (breitere Oberflächen-Evaluation).
@@ -0,0 +1,33 @@
---
type: issue
id: "0047"
status: open
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.