Deployment und Pflege

Kuglers Docs wird als eigene Anwendung betrieben und öffentlich unter docs.kuglers.at bereitgestellt. Die öffentliche Version enthält Architekturprinzipien, Projektbeschreibungen und Betriebsentscheidungen, aber keine internen Zugangsdaten oder privaten Netzwerkdetails.

Veröffentlichungsprozess

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

Pflegeprozess

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.

Kurze Seiten sind akzeptabel, wenn sie eine präzise Entscheidung dokumentieren. Lange Seiten sind nur sinnvoll, wenn sie echte Architektur oder Produktlogik erklären.

Öffentliche Grenzen

Kuglers Docs darf öffentliche Domains, Architekturprinzipien und Technologieentscheidungen beschreiben. Interne IP-Adressen, konkrete private Pfade, Tokens, Passwörter, ENV-Werte und vollständige Restore-Kommandos bleiben außerhalb der öffentlichen Dokumentation.