Skip to content

docs(i18n): zh-Hans for Deploy and the first Operate pages - #369

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 8 of the zh-Hans translation pass (docs/TRANSLATION.md). Branch reset to main after #368 merged; this PR carries only batch 8.

Files Change
deploy/{index,air-gapped,kubernetes,docker}.zh-Hans.mdx New translations, stamped
operate/{index,audit-logs,observability}.zh-Hans.mdx New translations, stamped
the matching *.zh-Hant.mdx (7) Generated by pnpm --filter @objectos/docs gen:zh-hant

Against the current English. These pages were first translated before #358 and #361 changed the image-pinning guidance. deploy/index, deploy/kubernetes, deploy/docker and operate/index were then brought up to the current English: an exact tag can be rebuilt, so pin the digest; read the digest with docker buildx imagetools inspect; the Enterprise image lists a private registry rather than digest pinning. They are stamped against today's English sha, so none is stale.

Terms. These pages use 操作 only for "operation" or a generic act: the operations flow (air-gapped), "rolling back the app and upgrading it are the same operation" (docker), and the audit action column, whose English reads "The operation (create, update, delete, auth, …)" (audit-logs). No ObjectStack action is rendered as 操作. Other fixed terms: air-gapped 物理隔离, deploy bundle 部署包, digest 摘要, control plane 控制平面, cloud posture 云端姿态.

Heading ids. Each translated heading carries the English page's id in Fumadocs' custom-id syntax (## 固定镜像 [#pin-the-image]). 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 b8ba72e, 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: 88 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 58 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, 17 missing (was 24)
check-translation-ownership.mjs --actor objectstack-fleet[bot] 0 TRANSLATION_BOT_LOGIN not set; 14 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/deploy/docker#pin-the-image 200, the anchor resolves to 固定镜像 at the top of the viewport; the docker buildx imagetools inspect block renders
/zh-Hans/docs/deploy/air-gapped 200, lang="zh-Hans", title 物理隔离部署:许可证模式和设置
/zh-Hans/docs/deploy/kubernetes (390×844) 200, title Kubernetes:探针、密钥、固定版本和迁移
/zh-Hant/docs/operate/audit-logs 200, lang="zh-Hant", title 審計日誌:每一次變更、登入和事件

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

Diff: 14 files, +2071 −0.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QsR2jTxGkQdrLm4E6n23Ub

Translate the Deploy overview, air-gapped, Kubernetes and Docker pages
and the Operate overview, audit logs and observability pages, against
the English that says to pin the image by digest. Code fences are byte
for byte; 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:27Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main (4ffefcc, after batch 7 landed), head b8ba72e, 14 files +2071/−0 = 2071 lines, under the 3000 line (zh-Hant included). First line Part of #347. Batch 8 under claim 6455420851 and amendment 6455441661. Only new zh-Hans / zh-Hant siblings.
  2. Content (deploy, first operate pages). New: deploy/index, air-gapped, kubernetes, docker, operate/index, audit-logs, observability. All are stamped. zh-Hant is generated (seat re-run of gen:zh-hant: 88 files, 0 written). Seat structure check on all 7 pages: heading counts match the English (8, 22, 8, 14, 8, 3, 5), every ## keeps its English id, and fenced code is byte-identical to the English. That includes the docker buildx imagetools inspect block from docs(reference): say where each image comes from and how to pin it in Supply chain #358/docs(deploy): an exact image tag can be rebuilt, so pin the digest #361.
  3. Terms. 操作 appears only for operation: the audit-logs action column, whose English is "The operation", the docker "same operation", and the air-gapped operations flow. All follow the ruling.
  4. Gates, seat re-run at b8ba72e. check-translations: zh-Hans 0 stale, 17 missing (was 0 and 24). check-translation-output --files: passed (85 pre-existing findings, report only). Check-runs: Ownership & freshness success · Node floor success · build pending. The merge queue re-runs build on the merge group before it lands.
  5. Out of scope. None.
  6. Landing. Tier none. Through the merge queue under the maintainer's standing go-ahead, after the main deploy for docs(i18n): zh-Hans for the Configure setup pages and Permissions #368 (4ffefcc) 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