Documentation as Code

Wie ADDXION® Dokumentation strukturiert und gepflegt wird.

Prinzip

Dokumentation lebt als Markdown/MDX im Repo addxion-docs und wird unter addxion.com/docs/ ausgeliefert. Marketing und CMS bleiben in addxion-com.

Pfade

Content-Ordner	URL
`src/content/docs/`	`/docs/`
`src/content/docs/ecosystem/`	`/docs/ecosystem/`
`src/content/docs/neon/`	`/docs/neon/`
`src/content/docs/ai/`	`/docs/ai/`
`src/content/docs/patterns/`	`/docs/patterns/`
`src/content/docs/branding/`	`/docs/branding/`
`src/content/docs/{xi,shell,behavior}/`	`/docs/{block}/`

Die Navigation wird in astro.config.mjs definiert. Unterverzeichnisse können per autogenerate eingebunden werden.

LLM-Index

Datei	Repo	Zweck
`public/llms.txt`	addxion-com	Marketing-Index mit Links
`public/llms-full.txt`	addxion-com	Volltext nur Marketing-Seiten
`public/llms.txt`	addxion-docs	Plattform-Docs-Index

Bei neuer Plattform-Doc: addxion-docs Content + llms.txt dort. Bei neuer Marketing-Seite: addxion-com llms.txt und ggf. llms-full.txt.

Siehe auch Websites entwickeln.

Konventionen

Produktname: Neon, AI
Docs auf Deutsch (wie Marketing)
Code-Beispiele aus echten Repos, nicht abstrahiert

Das Truth-Prinzip (Meta)

Truths sind SSOT — auch für sich selbst. Kanonische Wahrheiten nur in Truths. Jede andere Doc-Seite listet am Ende ## Truths (IDs) und ## Für Agents (Handlung). Consumer-Repos: ## Truths in AGENTS.md.

Was	Wo
Volltext einer Truth	`ecosystem/truths.md`
Relevante Truths pro Seite	`## Truths` am Seitenende
Handlungsregeln für Agents	`## Für Agents` direkt darunter

Truths (Pflicht-Sektion)

Jede Doc-Seite trägt am Ende zuerst ## Truths, dann ## Für Agents. Truths sind festgehaltene Wahrheiten; ## Für Agents enthält Handlungsregeln für Coding-Agents.

SSOT

Alle Plattform-Truths leben zentral in Truths — Plattform-Wahrheiten. Doc-Seiten listen nur relevante Truth-IDs — keinen Volltext.

Meta-Truth T-TRUTHS-SSOT: Die Truth-Registry ist selbst SSOT — auch das Prinzip „Truths überall referenzieren“ ist eine Truth.

Vorlage

## Truths

| ID | Wahrheit |
|----|----------|
| [T-DOC-SECTIONS](/docs/ecosystem/truths/#t-doc-sections) | Jede Doc-Seite: ## Truths + ## Für Agents |
| [T-TRUTHS-SSOT](/docs/ecosystem/truths/#t-truths-ssot) | Truths-Registry — referenzieren, nicht duplizieren |
| [T-PLATFORM-SSOT](/docs/ecosystem/truths/#t-platform-ssot) | Plattform-Wahrheit nur in addxion-docs |

## Für Agents

**Scope:** Wie ADDXION-Dokumentation strukturiert und gepflegt wird.

- Jede Doc-Seite endet mit `## Für Agents` (diese Konvention)
- Neue Seite: Frontmatter `title` + `description`, Agent-Sektion nicht vergessen
- Plattform-Docs nur in addxion-docs; `bun run build` vor Merge