Zum Inhalt springen

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.
  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.

Bearbeitet wird im Repository

Ä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.