Translate Repository Documentation
Read the pairing contract, translation rules, generated terminology, and docs-governance before translating.
Triage
- Existing pair, one side changed: use the sidecar hashes to identify the authored side and patch the smallest affected counterpart unit.
- Both sides changed or the recorded blob is unavailable: reconcile the complete affected section manually.
- New pair: translate section by section while preserving structure.
- Rename/delete: move/delete English, Chinese, and sidecar together.
Do not silently repair inaccurate technical content during translation. Report the source defect or fix both languages against current code when the task authorizes it.
Batch work
When the user requests a domain or corpus backfill, divide files into disjoint domain-owned sets. Translation workers read the complete rules and terminology, modify only assigned pairs, and return pending terms. The integrating agent resolves terminology in scripts/i18n-glossary.json, regenerates the terminology page and indexes, checks links/structure, records sidecars, and runs the corpus gate.
Finish
Verify clauses, identifiers, code fences, lists, tables, links, frontmatter, and natural phrasing. Then run:
pnpm docs:check-pairing --write <pair>
pnpm docs:check-pairing <pair>
Run pnpm docs:check once at PR level. A green pairing gate does not prove semantic fidelity.