Beschreibe den Doku-Leseweg über die gebaute MkDocs-Seite

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

deploy/README.md

@@ -17,6 +17,7 @@ Chart selbst gehört zu hive (Schnitt im Haupt-README).
 | Quelle | `git.home`, Organisation `ahmann`, Namespace `familie`, Klassifikation `home` |
 | Oberfläche | `https://hive.home/km/` (SilverBullet, Login aus OpenBao `elton/km-home`) |
 | API | `https://hive.home/km/api/v1/…`, `https://hive.home/km/health` |
+| Doku | `https://hive.home/doku/info/` — statische MkDocs-Seite aus dem info-Checkout, von km nach jedem Pull mit Änderung gebaut (`/srv/km/data/site/info`, Caddy `file_server`) |
 | Takt | alle 5 Minuten: ziehen, Gitea einlesen, indexieren, Geändertes committen und pushen |
 | Vektoren | **aus** (`KM_EMBED=0`) — erst, wenn es einen Abnehmer gibt; die Ollama-Instanz auf s18 ist vom LXC aus ohne VLAN5-Route nicht erreichbar |
 | 42i-hc | `/srv/km/health` prüft die API und den letzten Lauf |
@@ -59,6 +60,16 @@ Firmen-Token gehört nicht auf den Familien-LXC), wird es **im LXC gebaut**:
    initialisiert die Ablage deshalb **in place** und holt den Remote-Stand
    dazu; `.silverbullet*` und `*/doku/` stehen in der `.gitignore` der Ablage.
 
+## Doku lesen: MkDocs statt SilverBullet
+
+Andreas, 04.09.: SilverBullet ist für die Doku nicht das Richtige — sie soll
+aussehen wie sie soll, lesen statt editieren, ohne Auto-Commit-Problem. km
+baut deshalb jede Quelle mit `mkdocs.yml` nach jedem Pull mit Änderung als
+statische Seite (`mkdocs-material` im Image, ~60 s auf dem LXC) nach
+`/srv/km/data/site/<name>`; Caddy mountet das Verzeichnis read-only und
+liefert es unter `/doku/<name>/` aus. Ein Baufehler lässt die alte Seite
+stehen und erscheint im Lauf-Ergebnis (`site_<name>: FEHLER …`).
+
 ## Oberfläche: Seitenleiste
 
 SilverBullet hat keine Ordnernavigation. Die liefert das **TreeView-Plug**