Doku-Topologie: Wiki liegt auf git.lab, wiki.lab als gemeinsame Leseflaeche

Warnung ergaenzt, dass der wiki-Branch ein ueberholter Mai-Abzug ist und nicht
die gepflegte Fassung (ADR-0006 im management-Repo).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj
This commit is contained in:
Thore Cimbal
2026-08-01 12:00:00 +00:00
co-authored by Claude Fable 5
parent ba9783fa08
commit cdecb006d4
2 changed files with 24 additions and 4 deletions
+9 -1
View File
@@ -39,7 +39,8 @@ Gitea; the mirror delivers). **Never push directly to Gitea** for this repo —
force-overwrites divergent state. The same rule applies to ThreadNet-Web, threadnet-call,
thread-net-git, threadnet-operating and (since 2026-08-01) `management` (the former
`Backlogs` repo, renamed in the PM-framework restructuring — ADRs/vision/roadmap live
there); only this repo's **wiki** is still direct-to-Gitea.
there). **Since 2026-08-02 the wiki lives on git.lab too** — there is no direct-to-Gitea
exception left.
**Issues live on git.lab** (migrated 2026-08-01, gitops#48): the old Gitea issues are
closed with a pointer to their GitLab counterpart. ⚠️ gitops issue numbers **shifted**
@@ -50,6 +51,13 @@ One exception: **deploy-handover issues** stay on the Gitea `sorb/management` tr
because CFGMON has no route to git.lab (to be retired by the site-to-site VPN, ADR-0004
in the management repo).
**Wiki** (migrated 2026-08-02): the 15 pages now live in this project's GitLab wiki
(`…-gitops.wiki.git`, *Wiki* tab). ⚠️ The **`wiki` branch in this repo is NOT the wiki** —
it is a stale May snapshot of `docs/`; don't edit or trust it. All doc sources
(platform wiki, `homelab/docs`, `management`) are also served side by side as one
Docusaurus site at **wiki.lab**, configured in `git.lab/homelab/wiki` — content is
pulled at build time, so edits always belong in the source repo.
**Exception that needs manual handling**: the monthly TURN-rotation CronJob runs in the
cluster (no route to git.lab) and still opens its PR on Gitea. Never merge that PR on
Gitea — instead fetch the rotation branch, merge it into main locally, push to git.lab;
+15 -3
View File
@@ -142,8 +142,20 @@ gebündelt.
Lab auflösbar) — dort wird gepusht und läuft der CI-Verifikations-Job (`.gitlab-ci.yml`).
Die Kopie auf `rohana.axion1337.de` ist ein automatischer **Push-Mirror** und bleibt die
**Flux-Quelle**: der Cluster zieht unverändert von Gitea, der Mirror liefert. **Niemals
direkt nach rohana pushen** — der Mirror überschreibt divergente Stände. Issues, Wiki und
Releases bleiben auf Gitea.
direkt nach rohana pushen** — der Mirror überschreibt divergente Stände.
**Issues und Wiki liegen seit 2026-08-01/02 ebenfalls auf git.lab**
([Issues](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/issues) ·
[Wiki](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/wikis/home) — der
Wiki-Reiter oben im Projekt). ⚠️ Die Issue-Nummern haben sich beim Umzug verschoben;
ein alter Verweis „gitops#N" meint die Gitea-Nummer, verbindlich ist der
Migrations-Fußtext im jeweiligen Issue. **Releases bleiben auf Gitea** (öffentlicher
Download-Pfad). Der `wiki`-Branch in diesem Repo ist ein **überholter Abzug von
`docs/` aus dem Mai** und nicht die gepflegte Fassung.
Alle Dokumentationsquellen zusammen (Plattform, Homelab, Arbeitsweise) gibt es unter
**[wiki.lab](https://wiki.lab)** — Konfiguration im Repo
[`homelab/wiki`](https://git.lab/homelab/wiki).
**Abhängigkeits-Logik:** Flux installiert erst `infra-apps` (damit Namespaces und Repositories existieren) und danach `production-apps` (das eigentliche ESS-Chart).
@@ -292,5 +304,5 @@ sops apps/production/custom-configs/mas-secret.yaml
* **`CLAUDE.md`** (Repo-Root): Technische Referenz für KI-gestützte Arbeit an diesem Repo - Architektur, bekannte Chart-Quirks, Troubleshooting-Checkliste.
* **`docs/TASKS.md`**: Backlog-Pointer zu den [Gitea Issues](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/issues) - Details werden nicht mehr doppelt gepflegt.
* **[Gitea Releases](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/releases)**: Versionshistorie (SemVer, `vMAJOR.MINOR.PATCH` als Änderungsgrößen-Konvention, kein Kompatibilitätsvertrag - siehe [[00-TASKS]] Wiki für die Konvention).
* **[Wiki](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/wiki)**: Ausführliche Historie, Incident-Notizen, Setup-Guides pro Komponente.
* **[Wiki](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/wikis/home)** (auf git.lab, Reiter *Wiki*): Ausführliche Historie, Incident-Notizen, Setup-Guides pro Komponente. Zusammen mit Homelab- und Verfahrensdoku auch unter **[wiki.lab](https://wiki.lab)**.
* **`docs/deployment-guides/`**: Detaillierte Guides für TURN-Server, Authentik, Monitoring, Element-Customization, Room-Policies, Moderation & Content-Scanning, Host-Wartungsbenachrichtigungen.