hns-oss-docs-readme-sync

# README 4-File Sync Procedure The GitHub-facing README set is 4 files at the repo root, ~1100 lines each: | File | Locale | Role | |------|--------|------| | `README.md` | en | **canonical / primary** — author here first | | `README.ko.md` | ko | derived | | `README.ja.md` | ja | derived | | `README.zh.md` | zh | derived | SSOT design reference for redesign work: `.moai/reports/readme-docs-redesign-20260713.md` (README full redesign draft + docs-site 12→11 section restructure + 6 new docs × 4 locales). ## Procedure 1. **Author** the change in `README.md` (English) only. Respect the section design from the SSOT report; keep the ~1100-line budget in mind. 2. **Derive** ko, ja, zh — same PR, one derived file per translator worker. Translate the changed sections minimally; do not rewrite untouched prose. 3. **Preserve verbatim** across all 4 files: code blocks, command names, badges, version strings, file paths, tables' structure, Mermaid direction, and the switcher header (below). 4. **Verify parity** (checklist below) before returning. ## Language-switcher header contract [HARD] All 4 files share the same switcher header near the top, linking the sibling files with the label set exactly: ``` English · 한국어 · 日本語 · 中文 ``` - The current file's own label renders as plain text; the other 3 are links to the sibling README files. - Never reorder, drop, or re-label the 4 entries. ## Section-order parity checklist - [ ] `grep -c '^## ' README.md README.ko.md RE...