Skip to content

docs(i18n): zh-Hans for the REST API, security, CLI and environment variables references and Support - #372

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

Files Change
reference/{rest-api,security,cli,environment-variables}.zh-Hans.mdx New translations, stamped
resources/support.zh-Hans.mdx New translation, stamped
the matching *.zh-Hant.mdx (5) Generated by pnpm --filter @objectos/docs gen:zh-hant

Against the current English. reference/security was first translated before #358 and #361. Its Supply chain section now matches the current English: where the Community and Enterprise images come from, pin by digest, and a rebuild re-pushes X.Y.Z onto new bytes. The hardening checklist line matches too. It is stamped against today's sha.

Terms. On these pages 操作 means "operation" or a generic act. Examples: cli "Operate on records from the terminal"; environment-variables "the same operation as an upgrade"; rest-api "any other operation is refused at the REST layer"; security system-context operations and "every CRUD operation". 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 c52b226, 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: 102 generated file(s) match the zh-Hans sources byte for byte (with #370's 簽 override)
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 80 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, 3 missing (was 8)
check-translation-ownership.mjs --actor objectstack-fleet[bot] 0 TRANSLATION_BOT_LOGIN not set; 10 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/reference/security#supply-chain 200, the anchor resolves to 供应链 at the top of the viewport
/zh-Hans/docs/reference/cli 200, lang="zh-Hans", title CLI 参考:每个 os 命令及其参数
/zh-Hans/docs/reference/rest-api (390×844) 200, title REST API:生成的端点、认证、OpenAPI
/zh-Hant/docs/reference/environment-variables 200, lang="zh-Hant", title 自託管部署的環境變數

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

Diff: 10 files, +2055 −0.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QsR2jTxGkQdrLm4E6n23Ub

…ariables references and Support

Translate the remaining large Reference pages and the Resources support
page. 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:53Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main (cb852c2, after fix(i18n): write 簽 not 籤 in generated zh-Hant (#366) #370 and batch 9 landed), head c52b226, 10 files, +2055/−0 = 2055 lines. That is under the 3000-line cap, zh-Hant included. First line Part of #347. Batch 10, under claim 6455420851 and amendment 6455441661. Only new zh-Hans / zh-Hant siblings.
  2. Content. New: reference/rest-api, security, cli, environment-variables, resources/support. All are stamped. In security, the Supply chain section follows the post-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 English: pin by digest (摘要) and the Community X.Y.Z digest, in the prose and the checklist. zh-Hant is generated with fix(i18n): write 簽 not 籤 in generated zh-Hant (#366) #370's override in place. The seat re-ran gen:zh-hant: 102 files, 0 written. Seat structure check on all 5 pages: heading counts match the English (21, 11, 9, 19, 6), every ## keeps its English id, and the fenced code is byte-identical to the English.
  3. Terms. Every 操作 translates operation.
  4. Gates, seat re-run at c52b226. check-translations: zh-Hans 0 stale, 3 missing (was 0 and 8). check-translation-output --files: passed, with 85 pre-existing findings (report only). Check-runs: Ownership & freshness success · Node floor success · build pending. The merge group re-runs build before landing.
  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 Operate production, backup, troubleshooting and upgrade, and five Reference pages #371 (cb852c2) 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