Dokumentationsmodell

Diese Seite ist das Betriebsmodell für öffentliche FluxonLab-Dokumentation. Sie hält FlowHub, Prompt Studio, Blog, Labs und die Hauptseite in einer gemeinsamen Navigation, ohne app-spezifische Runbooks zu vermischen.

Kanonische Orte

Inhalt	Ort	Regel
Öffentliche Cross-Product-Docs	apps/web/src/content/docs	EN im Root, DE unter de/, TR unter tr/.
Interne Site-, Medien- und Research-Pläne	docs/	Planung, Migration und Schadensberichte bleiben außerhalb der Public Nav.
Blog-Editorial-Runbooks	apps/blog/docs	Dort lassen, außer sie müssen öffentlich referenziert werden.
Tool-READMEs	README.md im Tool-Ordner	Setup nah am Tool halten und bei Bedarf öffentlich verlinken.

Navigation

• Start here — Orientierung, Quickstart, Status und Zugang.
• Products — einzelne Produktguides über das Portfolio hinweg, mit ehrlichen Statuslabels.
• Platform surfaces — FlowHub, Prompt Studio, Labs, Blog und FluxonLab Site.
• Reference — Privacy, Security, Prompt/Media-Regeln, Troubleshooting, Glossar.
• Operations — Docs-Modell, Release Checks, Commit/Push-Autonomie, Contributor-Regeln.
• About — Prinzipien, FAQ, Support.

Seiten-Template

Jede öffentliche Produkt- oder Plattformseite beantwortet: Status, Zweck, Zielgruppe, aktuelle Fähigkeiten, Zugang, Betriebsgrenzen, Verifikation und verwandte Docs.

Frontmatter

status: preview
owner: docs-platform
lastReviewed: 2026-07-07
appliesTo: ["flowhub", "prompt-studio"]

Frontmatter hilft Wartung und Routing; der sichtbare Body bleibt die eigentliche Erklärung.

Lokalisierung

EN ist die kanonische Autorenversion. DE und TR müssen echte Übersetzungen mit gleichem Status, Scope und denselben Warnungen sein. Einsprachige neue Public Docs bleiben draft: true.

Ehrlichkeitsregel

Keine Seite darf eine Fähigkeit als live darstellen, wenn Route, Build-Pfad oder Runbook nicht existieren. Nutze planned, preview oder internal, wenn etwas nicht offen ist.

Verifikation

npm --prefix apps/web run build
npm --prefix apps/blog run ci:blog