docs(i18n): complete the Tier-2 should-have docs for EPIC #5482 - #6662
Merged
Hmbown merged 15 commits intoSep 29, 2026
Merged
Conversation
Translate the 17 remaining should-have user-facing docs into Simplified Chinese under docs/zh_hans/, each with a language banner on its English original: PLUGINS, PLUGIN_BUNDLES, MEMORY, SANDBOX, WORKFLOW_AUTHORING, FLEET_WORKFLOW_TUTORIAL, DOCKER, TERMUX, ACCESSIBILITY, CACHE, CATALOG_REFRESH, BUILD_PERFORMANCE, VOICE, LOCALIZATION, REBRAND, HarmonyOS, CNB_MIRROR. With WEB.md already landed this closes the Tier-2 should-have list. Link hygiene in the same pass: 39 cross-links inside docs/zh_hans/ now point at the local translations with translated anchors, three pre-existing dead anchors are fixed, and docs/zh_hans/README.md lists the new entries. Structure is 1:1 with the English originals for all 17 pairs (headings, code fences, tables, lists, images and link counts verified); 205 relative links and 44 anchors resolve across docs/zh_hans. Refs Hmbown#5482
Translate the 17 remaining should-have user-facing docs into Simplified Chinese under docs/zh_hans/, each with a language banner on its English original: PLUGINS, PLUGIN_BUNDLES, MEMORY, SANDBOX, WORKFLOW_AUTHORING, FLEET_WORKFLOW_TUTORIAL, DOCKER, TERMUX, ACCESSIBILITY, CACHE, CATALOG_REFRESH, BUILD_PERFORMANCE, VOICE, LOCALIZATION, REBRAND, HarmonyOS, CNB_MIRROR. With WEB.md already landed this closes the Tier-2 should-have list. Link hygiene in the same pass: 39 cross-links inside docs/zh_hans/ now point at the local translations with translated anchors, three pre-existing dead anchors are fixed, and docs/zh_hans/README.md lists the new entries. Structure is 1:1 with the English originals for all 17 pairs (headings, code fences, tables, lists, images and link counts verified); 205 relative links and 44 anchors resolve across docs/zh_hans. Refs Hmbown#5482
Found while reviewing PR #3 against its English sources: - zh_hans/WORKFLOW_AUTHORING.md: drop the duplicated 模型 across the line break ("reject per-step model overrides"). - TERMUX.md, CNB_MIRROR.md: retarget two dead INSTALL.md anchors left behind when INSTALL.md was renumbered (#android--termux-arm64 -> #android--termux-arm64-preview, #4-install-via-cargo-... -> Hmbown#5-cargo-and-building-from-source). Both anchor fixes are inside the PR's own review surface (the same sentences in the new zh_hans translations were part of its dead-anchor sweep claim). Refs Hmbown#5482
scripts/check-contributor-credit.py requires every commit author since v0.9.13 to appear on all three credit surfaces. docs/CONTRIBUTORS.md and CHANGELOG.md already carry the entry; web/lib/release-credits.ts did not, which reddened the fork PR's Version drift job.
…n standard - provider -> 提供商, matching the earlier translation PRs (Hmbown#4908 unified 服务商/提供商/提供方 to 提供商). The older zh_hans corpus already uses it 148 times; the new batch had drifted to 模型提供方. First mention per file carries an （provider）annotation. - Constitution -> 宪章（Constitution） in PLUGIN_BUNDLES. - First-mention （agent）/（subagent）annotations added across the batch. Refs Hmbown#5482
The earlier translations use 转录 (68 occurrences, defined in GUIDE.md as 转录区（对话记录，Transcript）); this batch had drifted to 对话记录. Both mentions now read 转录（transcript）. Refs Hmbown#5482
Three files this PR also touches (they carry link retargeting here) still used the drifted terms. GUIDE.md/AGENT_RUNTIME.md: 对话记录 -> 转录 (the glossary cross-reference lines 转录区（对话记录，Transcript） stay). MCP.md: bare 提供方 -> 提供商（provider）. BUILD_PERFORMANCE.md: move the （provider） annotation to its true first mention and render the rustls crypto provider as 加密提供器（crypto provider） so it does not read as a model provider. CATALOG_REFRESH.md: lift the （agent） annotation out of its enclosing parens. Refs Hmbown#5482
WEB.md was translated before the terminology pass landed and still said 模型提供方 in three places. The standard is 提供商（provider）; annotate the first occurrence the way the rest of the corpus does. Refs Hmbown#5482
Rewrite the 17 Tier 2 documents so a Chinese reader parses them as Chinese rather than as transliterated English: split comma chains at sentence boundaries, move preposed heavy modifiers into predicate position, replace 被-chains with named subjects, and drop nominalisation that exists only because the English has it. Eight read-only reviewers then checked every changed passage against its English source, and this commit carries their fixes too. The ones that mattered: - TERMUX restores the imperative "treat as potentially available" framing — a declarative rewrite had softened a security boundary. - PLUGIN_BUNDLES: 没有任何组件能被诚实地激活 (the possessor had drifted from the bundle to Codewhale), per-bundle generation, "only through" keeps its exclusivity, rejected renders as 拒绝 not 报错. - PLUGINS: 插件包格式, not 格式清单 (清单 means "manifest" in this file); the reload toast goes back to one sentence. - FLEET_WORKFLOW_TUTORIAL keeps Runtime as the component name. - LOCALIZATION keeps fail-closed as the main clause and drops an invented 我们 and 提示你补齐. - HarmonyOS restores 总 (always) and renders proves as 证明. - BUILD_PERFORMANCE: the ~2 GB / ~35 s 收益 sentence gets its subject back; crypto provider is 提供商 in both mentions. - DOCKER: 写入数千个小文件; can fail is 可能失败, not 就会失败. - MEMORY/REBRAND/CACHE: 仍然受支持, not 都不受影响; the migration sentence gets its subject back. - CATALOG_REFRESH keeps 已知 and uses 事实来源 throughout. - WORKFLOW_AUTHORING uses 表面 for surface and no longer opens the search-spec list with 这串东西. Verified: 17/17 structural 1:1 against the English sources, 205 relative links and 44 anchors resolve, and a screen over every changed line finds no number altered and no strength word weakened. Refs Hmbown#5482
Contributor
Author
|
I've recently been trying to develop a multi-agent collaboration system, and I've been testing it over the past few days, but something went wrong just now—one of the agents interpreted the task of reviewing SparkofSpike#3 on the Review branch as reviewing #3 on the upstream. It left a comment on #3 and opened #6661, which I immediately closed. I'm really sorry for the trouble this caused. |
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
Hmbown
approved these changes
Sep 29, 2026
Hmbown
left a comment
Hmbown
left a comment
Owner
There was a problem hiding this comment.
thank you so much for these!!! no worries on the agent mishap - I totally get it - trust me!
…nglish main's Hmbown#6672 rewrote docs/CATALOG_REFRESH.md for Hmbown#6396: the offline seed is generated by seed lock / seed render and CI rejects hand edits with seed render --check, and layer 5 (bundled Codewhale facts) became layer 12 (Codewhale corrections in catalog_corrections.json). The translation still described a hand-prepared seed and layer 5. Bring it level and restamp the sync date. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014ZwqatxgVFxHvovngywnks
The main merge carried @SparkofSpike into RELEASE_CONTRIBUTORS (the 0.10.1 list) because the release cut emptied UNRELEASED_CONTRIBUTORS. This PR ships in 0.10.1, so that placement is right; add the matching docs/CONTRIBUTORS.md v0.10.1 entry and the requiredCandidateCredits handle so the three credit surfaces agree. The CHANGELOG 0.10.1 Contributors bullet lands with the release branch. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014ZwqatxgVFxHvovngywnks
Hmbown
added a commit
to SparkofSpike/CodeWhale
that referenced
this pull request
Sep 29, 2026
…ks resolve Hmbown#6663's banners and README links point at zh_hans/LOCALIZATION.md, SANDBOX.md, WORKFLOW_AUTHORING.md and FLEET_WORKFLOW_TUTORIAL.md, which only Hmbown#6662 adds; merging Hmbown#6663 first would ship dead links. With Hmbown#6662 in its ancestry Hmbown#6663 is self-consistent, and merging Hmbown#6662 first then Hmbown#6663 is clean. docs/zh_hans/README.md conflict: take Hmbown#6662's local-translation links and new entries, keep ./TOOL_SURFACE.md (translated here), renumber the developer list with Hmbown#6662's three entries before this PR's ten, drop the "Tier 3 still untranslated" sentence, and restamp the date. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014ZwqatxgVFxHvovngywnks
Hmbown
added a commit
to SparkofSpike/CodeWhale
that referenced
this pull request
Sep 29, 2026
Hmbown#6662 adds the credit line; this PR, which contains Hmbown#6662, extends it with the Tier-3 developer docs. release-credits.ts and requiredCandidateCredits already carry the handle through the merge. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014ZwqatxgVFxHvovngywnks
Preserve SparkofSpike original PR Hmbown#6662 history. Resolve candidate-credit union and retain current OpenCode Zen protocol mapping with the contributor localized section link. Integration checkpoint only: inherited web credit-parity failure is still pending repair; no tests run for this merge.
Keep SparkofSpike's original PR Hmbown#6662 and its translation commits. Credit the pending work in the existing unreleased website list and an unreleased ledger/changelog section instead of changing the published 0.10.1 record. The TUI changelog mirror is synchronized. Correct English and Chinese catalog guidance together: generated seed edits do not persist like runtime corrections, and agent summaries belong in the PR body. Date the inherited v0.9.13 rebrand state as a historical snapshot. The preceding merge retains current Zen protocol prose with the valid localized link, and unions existing contributor credits. Verification on frozen source, inspected coordinating-root receipts: - npm test: 636 passed (68 + 16 + 50 + 502), 0 failed. - npm run check:web: passed, including 839 generated pages. - Changelog mirror and contributor-credit history gates passed (7 contributors). - 17/17 new translations have source/sync headers and matching heading structure. - 28 changed Chinese docs: 201 local links and 40 fragments checked with installed Marked/github-slugger; no missing paths or section anchors. - git diff --check passed. No Rust build or provider call needed for this slice. Root logs: /private/tmp/cw-6662-{npm,web}-root.log. Hosted CI on this new head remains a separate merge gate.
Hmbown
added a commit
to SparkofSpike/CodeWhale
that referenced
this pull request
Sep 29, 2026
Preserve SparkofSpike original PR Hmbown#6663 history and integrate final PR Hmbown#6662 head 4902468. Resolve the sole contributor-credit conflict by retaining both contributions under Unreleased, outside the existing 0.10.1 candidate. Local integration checkpoint before bounded documentation repairs. git diff --check passed. Mandatory npm test and check:web not yet run for this merged tree; no Rust build, hosted CI, or release claim.
Hmbown
added a commit
to SparkofSpike/CodeWhale
that referenced
this pull request
Sep 29, 2026
Preserve SparkofSpike's original PR Hmbown#6663 and its dependency on final Hmbown#6662 head 4902468 through ordinary merge checkpoint 528b272. Add the missing command/control-plane source/sync header and extend Unreleased changelog credit to the thirteen Tier-3 translations. Keep the existing 0.10.1 candidate credit record. Validation: npm test 636 passed, 0 failed (68 + 16 + 50 + 502). Final npm run check:web passed, including 839 generated pages. It was rerun after restoring the already-valid automatic-workflow fixture link; that source is unchanged from the original contribution. Logs: /private/tmp/cw-6663-npm-root.log /private/tmp/cw-6663-web-final-root.log All 13 new translations have source/sync headers and matching heading hierarchy. Marked/github-slugger verified 40 relative links and 7 fragments with zero missing targets. Changelog mirror and contributor-credit history checks passed (7 contributors); git diff --check passed. These are bounded source/link/credit and local web gates, not a complete semantic translation audit or hosted CI/release claim. No Rust build or provider call was made for this documentation slice.
Preserve SparkofSpike's original docs/zh-hans-tier2-should-have history at 4902468 and merge current main b66b4ab as an ordinary second parent. Resolve the sole conflict in docs/public-surface-facts.json by keeping main's complete contributor union, including wuisabel-gif and SparkofSpike once each. Both changelogs, the contributor ledger and website retain PR Hmbown#6662's Unreleased credit. All 17 original new translations remain byte-identical; the final diff against main is docs and credits only. Verified on index tree 95fcda8: - npm test: 670 passed (68 + 16 + 50 + 536), 0 failed, 0 skipped. - npm run check:web: passed. - Changelog mirror check: passed. - Contributor-history check: 7 contributors, all three surfaces credited. - Final PR diff check: passed; version/build manifests exactly main. Parent-run gate logs: /private/tmp/codex-6662-main-root-{npm,web}.log. Full merge-versus-old-parent whitespace check reports three unchanged main diagnostic-fixture trailing spaces; no edits to those source fixtures. No Rust build or provider call. Hosted CI on this merge remains required. Signed-off-by: Hunter B <hmbown@gmail.com>
Hmbown
added a commit
to SparkofSpike/CodeWhale
that referenced
this pull request
Sep 29, 2026
Preserve SparkofSpike's original Tier-3 branch and merge published Hmbown#6662 head d0ffbff, including main at b66b4ab, without rewriting history. The automatic merge required no manual conflict resolution. All 13 new Tier-3 translations remain byte-identical to original head 300d4f8. The resulting delta over Tier-2 contains 30 documentation/credit paths; production and version files match the merged dependency. Validation on tree fe53b04: - npm test: 670 passed (68 + 16 + 50 + 536), 0 failed, 0 skipped. - npm run check:web: passed, including all 839 generated pages. - Changelog mirror and contributor-credit coverage: passed, all 7 contributors since v0.10.0 credited on all three surfaces. - Strict diff-check reports eight original Markdown hard-break line endings in AUTOMATIC_WORKFLOWS.md; those original bytes are preserved. All other whitespace checks pass. Root-run logs: /private/tmp/codex-6663-main-root-{npm,web}.log. No Rust build or provider call; hosted CI remains separate. This PR continues to depend on Hmbown#6662 landing first. Signed-off-by: Hunter B <hmbown@gmail.com>
Hmbown
pushed a commit
that referenced
this pull request
Sep 29, 2026
…to zh_hans - 13 new Simplified-Chinese translations under docs/zh_hans/: RUNTIME_API, ARCHITECTURE, TOOL_SURFACE, AUTOMATIC_WORKFLOWS, AUTHORIZATION_ORDER, LIVE_SMOKE, COMMAND_CONTROL_PLANE, ENVIRONMENTS, LEGACY_PATHS, OPERATIONS_RUNBOOK, WORKROOM_ARCHITECTURE, WORKROOM_SECURITY, AGENT_ETHOS (structure verified 1:1 per document: headings, code fences, table rows) - The 13 English originals and docs/LOCALIZATION.md get the "read in Simplified Chinese" banner linking to their zh_hans translation - docs/zh_hans/README.md: 3 links retargeted to the translations, 10 new entries, date refreshed - Terminology follows #4908 (provider -> 提供商) and the Tier 1/2 corpus - Cross-links follow the corpus convention: ../<X>.md when a document exists only in English, plain <X>.md when it has a zh_hans translation (the five links into Tier-2 documents resolve once #6662 lands) - In-page anchors point at the translated headings (#引导送达, #工作区恢复端点, #按项目覆盖485) instead of the English slugs carried over from the sources Refs #5482
48 tasks done
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #5482.
This adds SparkofSpike's seventeen Tier-2 Simplified Chinese guides, covering plugins and bundles, memory, sandboxing, workflow authoring, Fleet tutorials, Docker, Termux, accessibility, cache, catalog refresh, build performance, voice, localization, rebranding, HarmonyOS and the CNB mirror. English pages link to their translations, the Chinese index includes them, and existing Chinese guides use translated destinations where available. Commands, configuration keys and protocol identifiers retain their source spelling.
Merge this original contributor PR before #6663. All original contributor commits remain in its ancestry. The current ordinary merge includes main
b66b4ab46ceaa62801a7411b5d5c0261510099eawithout rewriting history. Its sole conflict was the public credit list; the resolution retains every current contributor once. All seventeen new translations are byte-identical to the previously reviewed contributor head. The final diff from current main contains only documentation and contributor-credit changes.Contributor credit remains under Unreleased in the canonical ledger, changelog/TUI mirror and website list; current candidate credits retain main's complete record. English and Chinese catalog guidance put agent summaries in PR bodies and distinguish persistent corrections from hand-edited seed values. The inherited v0.9.13 rebrand paragraph is explicitly historical.
Verified on
d0ffbffaf99e021fa7d3d58a5d7d7f84e203927b(tree95fcda8ab15e7cae01ee579990a213be3c1e7990):npm test: 670 passed (68 + 16 + 50 + 536), 0 failed, 0 skipped.npm run check:web: passed, including documentation checks and 839 generated pages.490246867ed2a52cd2f1343af354909b3504db4a. Production and version/build manifests match current main.git diff --checkpassed.These are local source, preservation and web-gate receipts. They do not claim a complete semantic translation audit, deployment, or current-head hosted CI success. No Rust build or provider call was needed. Hosted CI on this new merge remains required.