Initial: Tibi-Doku auf Starlight-Basis (Nova-Theme, Docker-Stack, Sync-Skripte)

README.md

@@ -0,0 +1,46 @@
+# Tibi Doku
+
+Entwickler- und später Anwender-Dokumentation für **Tibi-Server** und **Tibi-Admin-Nova**.
+Basis: [Astro Starlight](https://starlight.astro.build/) — Markdown-Quellen, statischer Build, eingebaute Volltextsuche (Pagefind). Theme an Nova angelehnt (Inter, Near-Black, Nova-Orange).
+
+Altes Demo+Docs-Repo liegt archiviert unter `cms/tibi-docs-legacy`.
+
+## Start
+
+```sh
+npm install
+npm run dev        # http://localhost:4321
+# oder
+make docker-up     # https://tibi-docs.code.testversion.online/
+make docker-down
+```
+
+## Docs pflegen
+
+Single Source bleibt in den Quell-Repos — hier wird nur gerendert:
+
+```sh
+npm run sync         # tibi-server/docs + tibi-admin-nova/docs übernehmen
+npm run sync:openapi # OpenAPI vom laufenden Server holen (TIBI_API_URL)
+npm run build        # prüfen, ob alles rendert
+```
+
+Eigene Seiten: `src/content/docs/{einstieg,nova,anwender,reference,adr}/`.
+
+## Struktur
+
+```text
+src/content/docs/
+  index.mdx          Startseite (Hero)
+  einstieg/          was-ist-tibi, schnellstart, begriffe
+  server/            SYNC aus tibi-server/docs (nicht von Hand editieren)
+  nova/              SYNC aus tibi-admin-nova/docs (+ konzept.md)
+  anwender/          Platzhalter Redakteurs-Doku
+  reference/         generiert (openapi), nicht von Hand
+  adr/               Architektur-Entscheide
+scripts/
+  sync-server-docs.mjs
+  sync-openapi.mjs
+```
+
+Siehe `AGENTS.md` für die Agenten-Regeln.