Dokumentationsworkflow

Neue Inhalte entstehen aus realen Änderungen an der Plattform. Eine Seite wird nur angelegt, wenn sie eine eigene Entscheidung, ein eigenes System oder einen wiederkehrenden Betriebsprozess dokumentiert.

Inhaltliche Regeln

Eine Seite gehört in Kuglers Docs, wenn sie mindestens eine dieser Fragen beantwortet:

• Was habe ich selbst entwickelt?
• Wie ist meine Plattform konkret aufgebaut?
• Welche Entscheidung habe ich getroffen und warum?
• Wie wird ein eigenes System deployed, geprüft oder wiederhergestellt?
• Welche Beziehung besteht zwischen meinen Projekten?

Eine Seite gehört nicht hinein, wenn sie nur erklärt, wie ein bekanntes Drittprodukt allgemein funktioniert.

Veröffentlichung

Der Veröffentlichungsprozess:

1. Inhalt im Adminbereich oder direkt als Markdown bearbeiten.
2. Frontmatter und interne Links prüfen.
3. Build ausführen.
4. Container aktualisieren.
5. Healthcheck prüfen.
6. Öffentliche Seite testen.

Qualität

Jede Seite soll eine klare Verantwortung haben. Kurze Seiten sind akzeptabel, wenn sie eine präzise Entscheidung dokumentieren. Lange Seiten sind nur sinnvoll, wenn sie echte Architektur oder Produktlogik erklären.