Skip to content

docs(i18n): zh-Hans for Operate production, backup, troubleshooting and upgrade, and five Reference pages - #371

Merged
zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-uqu1e8
Oct 28, 2026
Merged

zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-uqu1e8

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Requested by Steedos · project thread
Part of #347
Clause-②: no
Metadata-protocol: none

维护者速读

What changes

Batch 9 of the zh-Hans translation pass (docs/TRANSLATION.md). Branch reset to main after #369 merged; this PR carries only batch 9.

Files Change
operate/{production,backup,troubleshooting,upgrade}.zh-Hans.mdx New translations, stamped
reference/{cel,runtime-capabilities,objectql,skills-cli,field-types}.zh-Hans.mdx New translations, stamped
the matching *.zh-Hant.mdx (9) Generated by pnpm --filter @objectos/docs gen:zh-hant

Against the current English. operate/upgrade was first translated before #361. Its intro, step 3 and the roll-back section now say what #361 says: on Community the exact tag can be pushed again when a version is rebuilt, so pin its digest too. It is stamped against today's sha. Every ### ObjectStack 17.x heading keeps its English id (#objectstack-177 and so on), so the links from the changelog and the Docker page land.

Terms. On these pages 操作 appears only on upgrade, and only as a generic verb: "documents the procedure" (操作流程) and "back up before the real one" (对真实数据库操作之前). No ObjectStack action is rendered as 操作.

Heading ids. Each translated heading carries the English page's id in Fumadocs' custom-id syntax. A script writes them from the English headings in order.

Tests

Translation-only diff; no code or test files change.

Acceptance notes

  • ja/de/es/fr/ko page siblings are untouched (step 3 decision: keep them partial). No meta file changes in this batch.
  • Code fences are byte-identical to English, comments included.

Verification

All gates ran at d56729d, exit codes captured before any pipe.

Gates (ci.yml steps)
Gate Exit Verdict line
node apps/docs/scripts/gen-zh-hant.mjs --check 0 zh-Hant: 97 generated file(s) match the zh-Hans sources byte for byte
node .github/scripts/check-doc-samples.mjs 0 every ts/js block on 89 English page(s) parses with @objectstack/spec 17.7.0 · 103 pass
pnpm turbo run type-check --continue + pnpm turbo run build (NEXT_PRIVATE_STANDALONE=true) 0 build 56 s, under the verify lock
pnpm turbo run test 0 1 successful
check-locale-surface.mjs 0 every advertised URL has a source file and every source file is advertised
check-positioning.mjs 0 4 copies equal their constants; the brand is right in 739 pages
check-search-locales.mjs 0 all 8 locales answer 200, find every own page by its title
check-translations.mjs 0 translations gate passed; zh-Hans 0 stale, 8 missing (was 17)
check-translation-ownership.mjs --actor objectstack-fleet[bot] 0 TRANSLATION_BOT_LOGIN not set; 18 translation artifact(s) and 0 other file(s)
check-translation-output.mjs --files (changed files) 0 translation output gate passed (85 pre-existing findings reported)
check-translation-output.mjs --self-test 0 29 rule cases, every rule able to fail
Browser check (Playwright on `next start` of this build)
Page Result
/zh-Hans/docs/operate/upgrade#version-specific-steps 200, the anchor resolves to 特定版本步骤 at the top of the viewport
/zh-Hans/docs/reference/cel 200, lang="zh-Hans", title CEL 表达式:公式、谓词、模板
/zh-Hans/docs/operate/backup (390×844) 200, title 备份与灾难恢复
/zh-Hant/docs/reference/field-types 200, lang="zh-Hant", title 欄位型別:每個欄位儲存和顯示什麼

No page errors. Screenshots: pr9-*.png in the project's docs-347/ folder.

Diff: 18 files, +2239 −0.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QsR2jTxGkQdrLm4E6n23Ub

…nd upgrade, and five Reference pages

Translate the remaining Operate pages and the CEL, runtime
capabilities, ObjectQL, skills CLI and field types reference pages.
Code fences byte-identical to English; stamped; zh-Hant regenerated;
headings keep the English ids.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QsR2jTxGkQdrLm4E6n23Ub
@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

席位核对 · ACCEPT · 2026-10-28T00:36Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main (f44e307, after batch 8 landed), head d56729d, 18 files +2239/−0 = 2239 lines, under the 3000 line (zh-Hant included). First line Part of #347. Batch 9 under claim 6455420851 and amendment 6455441661. Only new zh-Hans / zh-Hant siblings.
  2. Content. New: operate/production, backup, troubleshooting, upgrade, and reference/cel, runtime-capabilities, objectql, skills-cli, field-types. All are stamped. upgrade carries the post-docs(deploy): an exact image tag can be rebuilt, so pin the digest #361 rebuilt-tag and pin-the-digest wording. zh-Hant is generated (seat re-run of gen:zh-hant: 97 files, 0 written). Seat structure check on all 9 pages: heading counts match the English, every ## keeps its English id, and fenced code is byte-identical to the English.
  3. Terms. Two 操作, both generic verbs on upgrade. No action is rendered as 操作.
  4. Gates, seat re-run at d56729d. check-translations: zh-Hans 0 stale, 8 missing (was 0 and 17). check-translation-output --files: passed (85 pre-existing findings, report only). The generated zh-Hant contains none of the four zh-Hant: the generator writes 籤 (lottery slip) where Traditional uses 簽 (sign): 籤核, 會籤, 請求籤名, 中籤發 on landed pages #366 phrases, so this PR's merge group passes --check whether fix(i18n): write 簽 not 籤 in generated zh-Hant (#366) #370 lands before it or after it. Check-runs: Ownership & freshness success · Node floor success · build pending. The merge group re-runs build before it lands.
  5. Out of scope. None.
  6. Landing. Tier none. Through the merge queue under the maintainer's standing go-ahead, after fix(i18n): write 簽 not 籤 in generated zh-Hant (#366) #370 lands and its main deploy smoke-checks green.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants