2026-03-15 03:30:35 +02:00
|
|
|
# OpenChamber Docs Source
|
|
|
|
|
|
|
|
|
|
This package is the source-of-truth for OpenChamber public docs content.
|
|
|
|
|
|
|
|
|
|
## Layout
|
|
|
|
|
|
2026-05-23 00:33:39 +03:00
|
|
|
- `content/docs/*.mdx` - English docs pages (source of truth)
|
|
|
|
|
- `content/docs/<locale>/*.mdx` - translations, mirroring the English filenames
|
2026-08-29 12:14:19 +03:00
|
|
|
(e.g. `uk/`, `zh-cn/`, `pt-br/`, `fr/`, `tr/`); see `CONTRIBUTING.md` → Localization
|
2026-03-15 03:30:35 +02:00
|
|
|
- `sidebar.config.json` - docs navigation structure for Starlight sidebar
|
2026-05-23 00:33:39 +03:00
|
|
|
- `CONTRIBUTING.md` - authoring guide for adding pages, sections, and translations
|
2026-03-15 03:30:35 +02:00
|
|
|
- `DEPLOYMENT.md` - release/manual packaging and sync trigger model
|
|
|
|
|
|
|
|
|
|
## Local validation
|
|
|
|
|
|
|
|
|
|
Run from repo root:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
bun run docs:validate
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
This validates:
|
|
|
|
|
|
|
|
|
|
- frontmatter (`title`, `description`) exists for every MDX page
|
|
|
|
|
- sidebar links resolve to existing MDX routes
|
|
|
|
|
|
|
|
|
|
## Deployment model
|
|
|
|
|
|
|
|
|
|
This repo owns docs content.
|
|
|
|
|
|
|
|
|
|
Website rendering/deployment happens in `openchamber-website` (`apps/docs`).
|
|
|
|
|
|
|
|
|
|
Use `.github/workflows/docs-source.yml` to package docs source on release or manual trigger.
|
