Docs index
Docs System
How bilingual markdown docs are managed with Content Collections, wikilinks, and callouts.
Docs System
The docs layer is built with Astro Content Collections so routing, frontmatter, and locale pairing stay typed.
Rules enforced by the collection
- Only
enandzhare allowed locales. - Every document must declare a
translationKey. - Each locale must contain exactly one file for every supported translation key.
- Route slugs are stable so
[[wikilink]]targets remain simple.
If one locale is missing a document pair, the helper throws during content loading instead of silently shipping an incomplete docs tree.
Markdown enhancements
[[overview]]becomes a locale-aware docs link.[[shipping-model|shipping guide]]uses the alias as link text.> [!TIP]and similar blocks become styled callouts through a remark plugin.
Why this matters
The docs experience stays light because only the content pages and a tiny amount of supporting UI load around it. No client-side router is required.
For the broader site structure, return to overview.