Repository navigation
docs: add Chinese reading copies of the guide, reference, architecture, and setup docs - #149
Merged
Merged
Conversation
Widen the bilingual rule from the README, Specs, and Plans to the user guide, reference, architecture, and development docs, and check the copies with @perfectpan/lint-config/doc-translations (v0.9.0) instead of a local script: headings, code blocks, tables, list items, links and anchors in order, plus a source-blob stamp in each copy so that an edited English file fails until its copy is updated and recorded with --write. Correct six English statements that disagreed with the code: the bundled agent-kit version, which export fails on an empty trace, the default export file name, which ATIF steps carry is_copied_context, and which cut (80 or 500 characters) applies to titles and first prompts. Fix the review findings in the Chinese copies (NO_COLOR, what Estela never writes, the Ready line, the CI report, credential tokens as 令牌, and smaller drifts), and record all 15 stamps. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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
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.
Summary
*.zh-CN.md) of every document indocs/guide/,docs/reference/,docs/architecture/, anddocs/development/(14 files), and pointREADME.zh-CN.mdat them. Terms follow the UI glossary inapps/web/src/i18n/dictionary.zh-CN.ts, UI labels are quoted as the Chinese UI shows them, and credential tokens are 令牌.scripts/check-doc-translations.mjswith the shared check from@perfectpan/lint-config/doc-translations(v0.9.0, feat(doc-translations): share the translated Markdown check lint-config#13). Besides the pairing, the first line, and code blocks, it now compares headings in order, tables, list items, links (a link to a translated document must point to its copy) and anchors, and each copy carries a<!-- source-blob: <hash> -->stamp of the English file it was checked against, so editing an English file fails until its copy follows and is recorded with--write.is_copied_context, and which cut (80 or 500 characters) applies to titles and to first prompts.Validation
node scripts/check-doc-translations.mjs:doc-translations: ok (15 pairs). Editing one English file (docs/guide/mcp.md) made it fail withchanged since this translation was recorded (git show cff4d0f5a0f3 …); restoring the file passed again.gh repo-checks repository --staged,check-doc-translations,check-conventions(452 files),check-layers(8 projects),format.mjs --check,lint-scripts.mjsall passed.pnpm lintandpnpm typecheckwith lint-config v0.9.0: passed.pnpm-lock.yamlchanges only the lint-config resolution (21d4b41→1dcf174, thev0.9.0tag).pnpm installwarns about a missingvitepeer inapps/weband unapproved build scripts; both appear identically onmain.reviewerpasses over all 15 pairs against the English and the code; the first found four meaning errors (NO_COLOR, what Estela never writes, theReadyline, the CI report) and smaller drifts, all fixed; the second confirmed those fixes and the six English corrections against the code, and checked every stamp withgit hash-object.docs/reference/public-interface.mdis unchanged.pnpm test,pnpm build,check-browser-bundle.mjs,check-budgets.mjs— nothing underapps/orpackages/changed except Markdown; CI runs them.Risks
git show <hash>from the stamp prints the English text the copy last matched.