Skip to content

docs(zh): align Chinese translations with English source#3220

Merged
houko merged 1 commit into
mainfrom
docs/zh-en-alignment
Apr 26, 2026
Merged

docs(zh): align Chinese translations with English source#3220
houko merged 1 commit into
mainfrom
docs/zh-en-alignment

Conversation

@houko

@houko houko commented Apr 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Bring 18 Chinese mdx files in docs/src/app/zh/ back into structural and content parity with their English counterparts. The drift had accumulated as the EN docs evolved while the ZH versions stayed pinned to older revisions — missing sections, omitted table rows, condensed code examples, and in a few places sections in the wrong order.

Verification

Two checks were used to find and confirm fixes:

Check Before After
Structural drift (heading counts, code blocks, internal links) 14 / 61 files 0 / 61
Deeper drift (table rows, code-block line counts, prose ratio) 11 / 61 files 0 / 61

Notable gaps closed

  • agent/memory — added Table of Contents and the entire Memory Provider Plugin API section (5 subsections, 3 Rust code blocks)
  • agent/skills — added Skill Config Variables section (4 subsections, 3 code blocks, parameter table, TOC entry)
  • agent/templates — demoted category subheadings to H3, removed superfluous spawn blocks, dropped the EN-less 模型配置 section, reordered 理解 Temperature to match EN
  • agent/workflows — added TOC, moved Cron Jobs section to its EN position (between Trigger Engine and API Endpoints)
  • architecture/security — restored the missing 19.2 Architecture subsection, renumbered 19.3–19.6, added missing TOTP row in the systems overview table, completed the 19.6 Security Properties table and 19.3 / 19.4 flow steps
  • security/approvals — reordered Recovery Codes / Hardening Checklist / Session-Scoped Batch Resolution to match EN order
  • configuration/features — restored #### Streamable HTTP subheading and the enabled field row for [browser]
  • configuration/core — added the missing max_history_messages field row
  • integrations/api/intelligence — added GET /api/skills/{name} endpoint and replaced 3 outdated JSON examples
  • integrations/channels/core — fixed WhatsApp toml block that pointed at the wrong table ([channels.whatsapp] instead of [channels.whatsapp.overrides])
  • multiple files — added missing code-comment lines so EN/ZH code blocks have identical line counts

Files changed (18)

docs/src/app/zh/agent/hooks/page.mdx
docs/src/app/zh/agent/memory/page.mdx
docs/src/app/zh/agent/plugins/page.mdx
docs/src/app/zh/agent/skills/page.mdx
docs/src/app/zh/agent/templates/page.mdx
docs/src/app/zh/agent/workflows/page.mdx
docs/src/app/zh/architecture/page.mdx
docs/src/app/zh/architecture/security/page.mdx
docs/src/app/zh/configuration/core/page.mdx
docs/src/app/zh/configuration/features/page.mdx
docs/src/app/zh/configuration/features/session-reset/page.mdx
docs/src/app/zh/configuration/providers/management/page.mdx
docs/src/app/zh/integrations/api/intelligence/page.mdx
docs/src/app/zh/integrations/channels/core/page.mdx
docs/src/app/zh/integrations/cli/commands/page.mdx
docs/src/app/zh/operations/checkpoints/page.mdx
docs/src/app/zh/security/approvals/page.mdx
docs/src/app/zh/security/sandboxing/page.mdx

Documentation only — no code or build changes.

Test plan

  • pnpm --dir docs build succeeds
  • Spot-check /zh/agent/memory and /zh/agent/skills pages render the new sections in the dev server
  • Internal anchor links in newly-added TOCs resolve to the correct headings

Brought 18 Chinese mdx files into structural and content parity with
their English counterparts. The drift had accumulated as the EN docs
evolved while the ZH versions stayed pinned to older revisions —
missing sections, omitted table rows, condensed code examples, and
in a few places sections in the wrong order.

Verified with two checks (heading/code-block/table/link counts):
- structural drift: 14 files → 0
- deeper drift (table rows, code-block line counts, prose ratio): 11 → 0

Notable gaps closed:
- agent/memory: added Table of Contents and the entire
  "Memory Provider Plugin API" section (5 subsections, 3 Rust blocks)
- agent/skills: added "Skill Config Variables" section
  (4 subsections, 3 code blocks, parameter table, TOC entry)
- agent/templates: demoted category subheadings to H3, removed
  superfluous spawn blocks, dropped the EN-less "模型配置" section,
  reordered "理解 Temperature" to match EN
- agent/workflows: added TOC, moved Cron Jobs section to its EN
  position (between Trigger Engine and API Endpoints)
- architecture/security: restored the missing 19.2 Architecture
  subsection, renumbered 19.3–19.6, added missing TOTP row in the
  systems overview table
- security/approvals: reordered Recovery Codes / Hardening Checklist
  / Session-Scoped Batch Resolution to match EN order
- configuration/features: restored "Streamable HTTP" subheading and
  the `enabled` field row for `[browser]`
- configuration/core: added the missing `max_history_messages` row
- integrations/api/intelligence: added GET /api/skills/{name} endpoint
  and replaced 3 outdated JSON examples
- multiple files: added missing code-comment lines so EN/ZH code
  blocks have identical line counts

No code changes; documentation only.
@github-actions github-actions Bot added ready-for-review PR is ready for maintainer review area/docs Documentation and guides labels Apr 26, 2026
@github-actions github-actions Bot added no-rust-required This task does not require Rust knowledge size/L 250-999 lines changed labels Apr 26, 2026
@houko
houko merged commit ad806e8 into main Apr 26, 2026
23 checks passed
@houko
houko deleted the docs/zh-en-alignment branch April 26, 2026 08:14
@github-actions github-actions Bot removed the ready-for-review PR is ready for maintainer review label Apr 26, 2026
@houko houko mentioned this pull request Apr 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation and guides no-rust-required This task does not require Rust knowledge size/L 250-999 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant