hns-oss-docs-i18n-rules

# oss-docs HARD i18n Rules SSOT: `.moai/docs/docs-site-i18n-rules.md` (+ CLAUDE.local.md §17.1 for the design/icon regime). This skill is the working digest; on conflict, the SSOT wins — EXCEPT the two stale items in § Known-Stale below, where reality wins. ## 1. Canonical-locale chains [HARD] | Surface | Canonical | Derivation chain | Derived files | |---------|-----------|------------------|---------------| | docs-site | **ko** | ko → en → ja/zh, same PR | `docs-site/content/{en,ja,zh}/` | | README | **en** (`README.md`) | en → ko/ja/zh, same PR | `README.ko.md`, `README.ja.md`, `README.zh.md` | - Author in the canonical locale only; derive the rest. Never "fix" canonical content inside a translation — report the discrepancy back instead. ## 2. 4-locale simultaneous-update obligation [HARD] Every canonical content change MUST land in all 4 locales in the same PR. A canonical edit without its 3 derived counterparts is a locale-parity FAIL (sprint contract `locale-parity` threshold 1.0, must_pass). ## 3. Mermaid TD-only [HARD] - Allowed: `flowchart TD`, `graph TB`. - Forbidden: `LR` / `RL` directions (`flowchart LR`, `graph LR`, `flowchart RL`, `graph RL`). - Translation preserves diagram direction verbatim. ## 4. No emoji in body text [HARD] - Use the icon shortcode instead: `{{</* icon <name> [variant] */>}}` (defined in `docs-site/layouts/shortcodes/icon.html`; variants: `ok|warn|danger|primary|muted`). - Preserved (NOT emoji — do not strip): typographic ...