Thore CimbalandClaude Fable 5
70e81e2ff1
Gate 4, slice 2: decisions/0001-0011 moved via git mv with schema frontmatter prepended (status and date taken from each body's own Status line - 0007 stays proposed, its decision is open in #20; bodies unchanged except relative links gaining one directory level). The old scheme's README and template retire - their rules already live in AGENTS.md section 6 and the neckbeard ADR template. Every reference to decisions/ across the tree retargeted (root files, not-yet-moved verfahren/hosts/shared files, design doc and session ADR frontmatter). Verified: validate 0 errors (11 ported + 2 session ADRs + duplicate-id guard), gen_status --check current with all 13 ADRs listed, drift check 0 findings, negative test shows a cloned id 0012 firing the duplicate check. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.0 KiB
type, id, status, date, supersedes, superseded_by, related
| type | id | status | date | supersedes | superseded_by | related |
|---|---|---|---|---|---|---|
| adr | 0007 | proposed | 2026-08-02 | null | null |
0007 — Wiki-Oberfläche: Docusaurus läuft, BookStack als Gegenentwurf
Status: vorgeschlagen (Entscheidung offen → Issue #20) · Datum: 2026-08-02 · Entscheider: sorb
Kontext
ADR-0006 hat die Wikis ins Lab geholt und
Docusaurus als Lesefläche gebaut — läuft seit 2026-08-02 unter axionwiki.lab.
Danach kam der Wunsch nach einer BookStack-Variante, angeregt von der
ESS-Dokumentation von Element, die selbst auf
BookStack läuft und sehr aufgeräumt wirkt.
Beide Werkzeuge lösen dieselbe Aufgabe grundverschieden — deshalb ist das keine Werkzeugwahl, sondern eine Weichenstellung.
Entscheidung
Beide Varianten existieren parallel, bis an echten Inhalten entschieden wird —
und beide bleiben dabei ausschließlich im Homelab (bestätigt von sorb am
2026-08-02: keine Exponierung, solange nicht entschieden ist, ob überhaupt eine
der beiden dauerhaft eingebaut wird).
Docusaurus bleibt vorerst der produktive Weg (axionwiki.lab, läuft), BookStack
kommt als Vergleichsentwurf daneben (bookstack.lab, Repo
homelab/wiki-bookstack).
Die eigentliche Entscheidung wird vertagt — bewusst, weil sie an einer Frage hängt, die sich am Reißbrett nicht beantworten lässt: Soll Dokumentation künftig im Repo entstehen oder im Browser?
Der Unterschied, auf den es ankommt
| Docusaurus | BookStack | |
|---|---|---|
| Wo der Text lebt | in den Quell-Repos, beim Bau eingesammelt | in einer Datenbank |
| Wie geändert wird | Commit, Review, Git-Historie | WYSIWYG im Browser |
| Betrieb | statisches Image, zustandslos | Anwendung + MariaDB, backup-pflichtig |
| Suche | fehlt (Plugin nötig) | eingebaut |
| Rechte | alles oder nichts | je Buch/Regal |
| Quelle der Wahrheit | eindeutig das Repo | die Datenbank — neben den Repos |
Die letzte Zeile ist der Kern. Mit BookStack entsteht eine zweite Quelle der Wahrheit neben git.lab — genau das, was ADR-0002 für Issues gerade aufgelöst hat. Das kann richtig sein (Dokumentation hat andere Autoren und Lebenszyklen als Code), muss aber bewusst entschieden werden.
Konsequenzen
- Doppelter Betrieb auf Zeit. Zwei Stacks, zwei Domains. Vertretbar, solange es ein Vergleich ist; auf Dauer ist es Ballast — deshalb gehört zu dieser Entscheidung ein Verfallsdatum.
- BookStack braucht ein Backup, sobald es mehr als ein Versuch ist. Eine Datenbank ohne Sicherung ist eine Zeitbombe (vgl. CFGMON-09, wo genau das seit 2026-07-30 offen ist).
- Ein Einweg-Import zum Befüllen, aber keine Synchronisation (
import/im BookStack-Repo). Nachtrag 2026-08-02: Ohne Inhalte lässt sich nichts vergleichen, deshalb legtprovision.pydieselben drei Bereiche an wie das Docusaurus-Wiki. Ein wiederholter Sync bleibt bewusst aus — BookStack führt Inhalte in seiner Datenbank, ein zweiter Lauf würde dort Bearbeitetes überschreiben und Synchronität vortäuschen, die es nicht gibt. - Die Themes sind farbgleich zu den Element-Themes (Gruvbox Dark und Sunset Boulevard), damit der Vergleich nicht an der Optik hängt, sondern am Arbeitsmodell.
- Die Verliererseite wird abgeräumt, nicht „für später" behalten.
Verworfene Alternativen
- Direkt auf BookStack wechseln: Docusaurus läuft bereits und kostet nichts im Betrieb; ein Wechsel ohne belastbaren Vergleich wäre Geschmacksentscheidung.
- BookStack gar nicht ausprobieren: Die Frage „im Repo oder im Browser schreiben?" ist real und betrifft künftig jede Doku — sie lässt sich nur an echten Inhalten beantworten.
- Beides dauerhaft parallel: zwei Quellen der Wahrheit für dieselben Inhalte, garantierte Drift. Genau der Zustand, den der Wiki-Audit vom 2026-08-02 aufgedeckt hat (drei auseinandergelaufene Stände).