Creopus Docs Source — Single Source of Truth
This directory is the canonical source for all customer-facing and prospect-facing content. Every other artifact (Docusaurus site, prospect decks, in-app /whats-new page, sales-bot RAG corpus, in-app tours, broadcast emails) is generated from these markdown files. Never hand-edit downstream artifacts; edit here and regenerate.
Layout
docs-source/
├── features/ One file per feature, frontmatter-driven
├── personas/ Customer persona profiles (used by deck generator)
├── value-props/ Value-proposition pillars (stable content)
├── faq/ FAQ entries (also fed to sales-bot)
├── changelog/ Auto-generated per-release changelogs
├── tours/ In-app product tour definitions
└── decks/ Saved Marp deck blueprints (sales team can hand-edit)
Frontmatter contract
Every markdown file MUST have YAML frontmatter. Minimum fields:
---
id: unique-slug
title: Human-readable title
audience: [prospect, customer, internal]
stability: stable | volatile # affects deck generation: stable content always included
updated: 2026-05-06
tags: [auth, requirements, ai]
---
Feature files add:
status: shipped | beta | planned
shipped: 2026-04-15
related_personas: [hardware-eng-mgr, ce-engineer]
demo_url: https://... # optional MP4/Arcade
screenshot: /assets/screenshots/feature-x.png
Tour files (in tours/) add:
trigger: route:/tools | event:onboarding | manual
selectors:
- target: '[data-tour="prompt-input"]'
title: Prompt input
body: Type what you want to generate.
- target: '[data-tour="generate-button"]'
title: Generate
body: Click here to invoke the AI.
Workflow
- PM/eng edits markdown here.
- PR is opened. CI builds Docusaurus preview, runs Meilisearch index dry-run.
- On merge to main, GitHub Actions:
- Deploy Docusaurus to Cloudflare Pages.
- Re-index Meilisearch.
- Sync changelog to in-app
/whats-newAPI and broadcast via Listmonk.
- Sales/SE generates prospect deck on demand:
npm run deck:generate -- --persona=hardware-eng-mgr --account="ACME Corp".