Files
management/docs/issues/0020-doc-03-wiki-oberflaeche-entscheiden-docusaurus.md
T
Thore CimbalandClaude Fable 5 c23bb54a92 feat: slice 4 - the open management issues live in the repo
Gate 4, slice 4: 26 open management issues imported from live git.lab
(read-only, descriptions included as authorized; GitLab iid = file id,
labels/milestone/priority/due/host/area mapped into frontmatter, the
import aborts instead of inventing a missing milestone or priority).
Two new issues close the F-004 gap where work was really still open
(0033 OVERMIND-01, 0034 CFGMON-11 incl. the plaintext npm-token
rotation); CFGMON-12/13 already route to verified git.lab issues,
MATRIX-05 is done and needs none (agreed with sorb). The three wiki
task blocks now reference their issues, roadmap.md hands all counts to
the generated STATUS.md and states M1-M5 per ADR-0010 (closing F-001
in the canonical prose), pruefe_prosa joins the CI validate job, and
the import protocol under docs/sources/migration/ records every
intervention into imported text.

Verified: validate 0/0 over 29 issue files, gen_status --check current
(distribution line M1 9 - M2 17 - M4 2 plus per-issue milestone and
priority), pruefe_prosa 0 errors with clones and 0 errors/15 unchecked
citations in offline CI mode, drift check green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-11 12:00:00 +00:00

1.9 KiB

type, id, status, created, milestone, priority, due, area, gitlab_iid, related
type id status created milestone priority due area gitlab_iid related
issue 0020 next 2026-08-02 M2 medium 2026-08-31 infrastructure 20

DOC-03: Wiki-Oberfläche entscheiden — Docusaurus oder BookStack

Import aus management#20 (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).

Zwei Varianten stehen nebeneinander, damit an echten Inhalten entschieden wird statt am Reißbrett (ADR-0007):

Variante Stand Repo
Docusaurus läuft unter axionwiki.lab homelab/wiki
BookStack Stack fertig, noch nicht deployt 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.