Files

T

Thore Cimbal 0845af9c44 docs: decide Wiki.js (ADR-0014, supersedes 0007) + wiki build issues

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.

2026-08-12 12:00:00 +00:00

1.6 KiB

Raw Blame History

type, id, status, created, milestone, priority, area, related

type

status

created

milestone

priority

area

issue

0047

done

2026-08-12

low

infrastructure

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.

1.6 KiB Raw Blame History