Files
management/decisions
Thore CimbalandClaude Fable 5 7d7c1e86b0 ADR-0006: Wikis ins Lab konsolidiert, Docusaurus als gemeinsame Leseflaeche
Drei auseinandergelaufene Dokustaende aufgeloest: Gitea-Wiki-Repo (gepflegt,
nicht gespiegelt), wiki-Branch (Mai-Abzug von docs/), docs/ im main. Wiki liegt
jetzt im GitLab-Wiki; homelab/wiki baut daraus + homelab/docs + diesem Repo eine
Docusaurus-Seite. Damit entfaellt die letzte direkt-zu-Gitea-Ausnahme.

CLAUDE.md + README entsprechend nachgezogen; Rollout-Restarbeit als #18,
Branch-Entscheidung als #19.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj
2026-08-01 12:00:00 +00:00
..

Architecture Decision Records (ADR)

Eine Datei pro Entscheidung, fortlaufend nummeriert, Format siehe template.md (MADR-light). ADRs werden nie umgeschrieben — eine revidierte Entscheidung bekommt ein neues ADR, das alte wird im Status auf abgelöst durch NNNN gesetzt.

Wann ist ein ADR Pflicht:

  • Architektur- oder Prozessentscheidungen, die mehrere Repos/Hosts betreffen
  • Jede dauerhafte Ausnahme von einer bestehenden Regel — eine Ausnahme, die nur dokumentiert, aber nicht entschieden wurde, ist ein Fehler (gelernt beim git.lab-Cutover 2026-08-01: die „Übergabe-Issues bleiben auf Gitea"-Ausnahme hätte als Entscheidungsvorlage kommen müssen, nicht als Fußnote)
  • Verworfene Wege, deren erneute Prüfung Zeit kosten würde („warum haben wir das damals nicht gemacht?")

Kleine, repo-lokale Entscheidungen bleiben im jeweiligen Projekt (Commit-Message oder Issue) — nicht jede Abwägung braucht ein ADR.