# Dokumentation lokal schreiben & synchronisieren

Deine Projekt-Dokumentation lebt als Markdown-Dateien im verbundenen Repository. Lalabase
spiegelt sie schreibgeschützt — das Repository bleibt die einzige Quelle der Wahrheit.

Das ist bewusst so: Die Dokumentation wird nicht in Lalabase geschrieben, sondern von den
Entwicklern mit Repository-Zugriff in ihrem gewohnten Workflow gepflegt. Das bringt zwei Vorteile.
Erstens gibt es genau eine Quelle der Wahrheit: Sollte ein Team Lalabase einmal nicht mehr nutzen,
ist die Doku nicht verloren — sie liegt weiterhin als Markdown im eigenen Repository. Zweitens
lesen auch Kollegen ohne Repository-Zugriff — etwa nicht-technische Team-Mitglieder — die stets
aktuelle Dokumentation direkt in Lalabase, ganz ohne eigenen Git- oder Repo-Zugang.

Manche Teams lassen sich Änderungen zusätzlich von einem eigenen KI-Tool im Repository
zusammenfassen, bevor sie committen — das ist ein reiner Workflow-Tipp außerhalb von Lalabase,
keine Lalabase-Funktion.

## Dokumentation schreiben

1. Lege in deinem Repository einen Doku-Ordner an — Standard ist `.lalabase/doku/`.
2. Schreibe die Seiten als Markdown-Dateien und committe sie.
3. Push die Änderungen wie gewohnt zu GitHub.

## In Lalabase verbinden

1. Verbinde zuerst das [Repository mit dem Projekt](https://lalabase.com/docs/de/guides/repositories/connect).
2. Öffne den Bereich **Dokumentation** und klicke auf **Dokumentation verbinden**.
3. Wähle das Repository, gib den Ordner an (Standard `.lalabase/doku/`) und vergib einen Namen.
4. Speichere und starte über **Jetzt synchronisieren** den ersten Abgleich.

## Automatisch aktuell gehalten

Sobald das Repository mit einem Push-Webhook verbunden ist, aktualisiert sich die Doku hier von
selbst — niemand muss etwas von Hand übertragen. Wer mag, lässt die Dokumentation beim Programmieren
zusätzlich von einem KI-Tool im Repository mitschreiben und aktuell halten. Für Lalabase ist das
transparent: Es spiegelt einfach den jeweils neuesten Stand aus dem Repository.

## Suche und Chat

Die gespiegelte Doku ist kein isolierter Bereich. Ihre Seiten erscheinen in der globalen Suche, und
der KI-Assistent greift auf sie zu. Du kannst also ganz normal danach suchen oder im Chat eine Frage
zur Dokumentation stellen und bekommst eine Antwort auf Basis der aktuellen Seiten.

<div class="docs-callout docs-callout--info">
  <div class="docs-callout__title">Bearbeitet wird im Repository</div>
  <p>Änderungen machst du immer in den Markdown-Dateien im Repo, nie in Lalabase. Mit einem Push-Webhook synchronisiert sich die Doku automatisch; sonst stößt du „Jetzt synchronisieren" von Hand an. Das Logbuch zeigt jeden Lauf.</p>
</div>