Localization

Source of truth

Russian files are the normative source. Translations do not introduce new rules or independently correct meaning. The source changes first, followed by every supported locale.

Invariants

• directory structure and Markdown filenames match;
• document identifiers and explicit anchors are not translated;
• relative links point to the same logical documents;
• example identifiers remain unchanged;
• Mermaid text is translated while node and edge structure matches;
• type names follow the object catalog.

Adding a locale

1. Add the locale to Docusaurus configuration.
2. Generate UI strings with write-translations.
3. Copy every supported version tree into the locale directory.
4. Translate Markdown, the home page, and UI strings.
5. Validate file parity, links, diagrams, and search with a production build.

An incomplete locale is not published as supported: missing translation must not silently fall back to Russian text.