Doku-Zielgruppen — Leitplan
Diese Seite ist die strategische Einordnung der Dokumentation auf docs.cockpit-os.de. Jede neue Seite gehört einer Hauptzielgruppe — nicht alle drei gleichzeitig.
1. Content Creator / Redaktion (Hauptnutzer)
| Wer | Redakteurinnen, Marketing vor Ort, neue Mitarbeitende — Quereinsteiger, kein Technik-Verständnis nötig |
| Ziel | Mit dem System arbeiten können: Inhalte, Website (v0), Social, Freigaben — ohne Überforderung |
| Navbar | Redaktion |
| Einstieg | ★ Start hier |
| Sprache | Du, Alltagssprache, Begriffe erklären (v0, Outstand, MCP getrennt) |
| Struktur | Oben Kurzpfade & Checklisten, unten Detail eingeklappt |
| Nicht | API-Verträge, MEC-CSS-Checklisten, Architektur-Diagramme für Investoren |
Typische Pfade
| Aufgabe | Seite |
|---|---|
| Neu im Team | Start hier |
| Center-Website mit v0 | Website v0 (Kurzpfad) → v0 A–Z → Instructions |
| News, Shops, Events | Erste Schritte · Content Management |
| Social | Social (Einstieg) |
| Freigaben | Workflow · Social Freigabe |
| Suche / Index | Themenfinder · Strg+K |
Regel für Autoren: Neue Redaktions-Features → zuerst Kurzpfad oder Zeile auf Start-hier, dann Detailseite.
2. Geschäftsführung / Entscheider
| Wer | Asset Owner, Center-Betreiber (GF), Asset Manager, strategische Partner; bei Plattform-Firma zusätzlich Investoren (VC/PE) |
| Ziel | Verstehen: Warum das System so gebaut ist, warum es stark ist, was es kann — Vertrauen in die Plattform |
| Navbar | Plattform |
| Einstieg | Entscheider & Partner oder Plattform-Überblick |
| Begriffe | Kein „Geldgeber“ — in der Branche: Eigentümer, Betreiber, Investor, Partner |
| Sprache | Business & Architektur auf Augenhöhe, keine Code-Beispiele, keine Secrets |
| Struktur | Argumente, Vergleich Markt, Reife-Nachweise, Changelog als Lieferbeleg |
| Nicht | v0-Instructions kopieren, Dispatch-Bedienung, Developer-Gap-Analysen |
Typische Pfade
| Frage | Seite |
|---|---|
| Plattform-Nachweis / Partnerschaft / DD? | Entscheider & Partner |
| Was ist CockpitOS konzeptionell? | Plattform-Überblick |
| Ist das „echte“ Software? | Reife & Betrieb |
| DD-Checkliste | Due Diligence (Kurz) |
| Was wurde wann geliefert? | Änderungsprotokoll |
| Presse | Pressemitteilung — Texte |
Regel für Autoren: Keine Umsatzzahlen erfinden; Produkt- und Architektur-Fakten aus Code/Doku.
3. Entwickler / IT / AI-Coding-Tools
| Wer | Entwicklerinnen, Agenturen, DevOps, Cursor / Claude / MCP beim Code |
| Ziel | System erweitern, integrieren, debuggen — Architektur, APIs, Monorepo, Konventionen |
| Navbar | Entwickler |
| Einstieg | ★ Start Entwicklung |
| Sprache | Technisch präzise, Pfade im Repo, Verträge, Env-Namen (ohne Secret-Werte) |
| Struktur | Architektur → APIs → Apps/Packages → Spezialthemen (MEC, WordPress) eingeklappt |
| Nicht | „Du“-Onboarding für v0 (bleibt unter Redaktion) |
Typische Pfade
| Thema | Seite / Ort |
|---|---|
| Monorepo & Architektur | Start Entwicklung |
| Public API / v0 | API-Vertrag |
| AgencyOS / Partner | AgencyOS |
| MCP (Tools, Env) | packages/mcp-cockpit-os · README (Repo) |
| Maschinenlesbar | /ai-integration/cockpit-api-capabilities.json · OpenAPI unter /openapi/ |
| Dashboard-Navigation (Code) | apps/dashboard/src/config/navigation.ts · Navigation-Doku |
| Schema / DB | packages/database/schema.prisma · db_structure.md (Repo) |
| Cursor-Regeln (Repo) | .cursor/rules/ |
Hinweis MCP: Server-Instructions verweisen u. a. auf den Public-API-Vertrag. Vollständiger Kontext: Start Entwicklung.
Regel für Autoren: API-/Architektur-Änderung → Developer-Seite + ggf. Changelog; Redaktion nur bei sichtbarer Bedienungsänderung.
Übersicht Navbar (schlank)
Oben sichtbar: Start · Redaktion · Plattform · Entwickler · Weitere ▾ (Dashboard, Center-Website, Signage, Templates, Themen A–Z). Rechts: Suche, Sprache, GitHub.
| Navbar | Zielgruppe | Nicht verwechseln mit |
|---|---|---|
| Redaktion | Content Creator | Entwickler-APIs |
| Plattform | GF, Investoren, Partner | Redaktions-How-tos |
| Entwickler | Code, MCP, Cursor | v0-Anleitung (→ Redaktion) |
| Weitere → … | Querschnitt-Handbücher | Thema der passenden Zielgruppe zuordnen |
Pflege im Team
- Ablauf neue Seiten: Doku-Workflow
- Heuristik Code vs. Doku:
pnpm docs:check(Repo-Root) - Intern:
project_specs.md(Meilensteine, Doku-Nachzug)
← Entscheider & Partner · Start Redaktion · Start Entwicklung
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /plattform/doku-zielgruppen