Skip to content

docs(i18n): translate build/ and build/data/ into ja (#388, PR 1 of 7) - #389

Merged
zhuangjianguo merged 3 commits into
mainfrom
claude/project-thread-u7eoxi
Oct 29, 2026
Merged

zhuangjianguo merged 3 commits into
mainfrom
claude/project-thread-u7eoxi

Conversation

@zhuangjianguo

Copy link
Copy Markdown
Collaborator

Requested by Steedos · project thread
Refs #388
Clause-②: no
Metadata-protocol: none

维护者速读

  • 改了什么:Other locales, phase 2: ja to full coverage (the remaining 79 pages, seven serial PRs) #388 第 1/7 个 PR:新增 build/ 顶层 9 页和 build/data/ 4 页的日文译文。只新增译文文件,不动 en、zh-Hans、zh-Hant 和代码;build/meta.ja.json、build/data/meta.ja.json 已与英文一致,无需改动。
  • 为什么改:其他语言分阶段计划的第 2 阶段(2026-10-29 09:44Z 维护者同意):日文补全剩余 79 页,分 7 个串行 PR。
  • 风险与回滚:只加 13 个 locale 文件;其余 66 个日文页面仍回退英文。回滚即 revert 本 PR。
  • 先看:content/docs/build/ai-builder.ja.mdx 和 content/docs/build/data/validation-rules.ja.mdx。
  • 两分钟验证:打开 /ja/docs/build/ai-builder,正文为日文,无「未翻译」横幅;/ja/docs/build/data/relationships 锚点仍可跳转。
  • 需要你做的:无,席位落地。

What changes

Files Change
content/docs/build/{index,agents,ai-builder,ai-skills,extend-existing-systems,marketplace,packages,reports,templates}.ja.mdx New ja translations
content/docs/build/data/{index,relationships,formulas,validation-rules}.ja.mdx New ja translations

build/meta.ja.json and build/data/meta.ja.json already list the same pages as English, so neither changes.

Rules followed (docs/TRANSLATION.md), as in #387: product nouns stay English; glossary ja column; every heading keeps its English id (checked against the zh-Hans heading ids); fences filled from the English source byte for byte; MDX comments copied verbatim; UI control labels kept in English; each page stamped with check-translations.mjs --stamp; one line per paragraph.

The branch carries one merge of the already-merged #387 branch head so the push fast-forwards; the diff against main is only the 13 files.

Tests

Content-only diff. Local gates on 408661e:

  • check-translations: ja 0 stale, 66 missing (was 79), 0 guide-stale; zh-Hans 0/0/0; gate passed.
  • check-translation-output --files <changed>: no findings.
  • check-translation-ownership: 13 translation artifacts, 0 other files.
  • Every page parsed with mdast: no stray * left in text nodes (no broken CJK emphasis).
  • gen-zh-hant --check, check-doc-samples, type-check, build, test, check-locale-surface, check-positioning, check-search-locales all green.
  • Rendered with next start (playwright): /ja/docs/build/packages, /ja/docs/build/ai-builder, /ja/docs/build/data/relationships, /ja/docs/build/data/validation-rules at desktop 1280, /ja/docs/build/packages at mobile 390. All 200 with html lang="ja", ja H1 and body, no untranslated banner, no page or console errors.

Acceptance notes

  • PR 2 of 7 (build/automation/* + build/interface/*) opens only after this lands and main CI and smoke are green.

Generated by Claude Code

zhuangjianguo and others added 3 commits October 29, 2026 10:17
…ions, use)

Phase 1 of the other-locale plan. Adds ja translations of the 19
entry-path pages (index, why, start/*, editions/*, use/*) and the ja
sidebar labels for start/ and editions/. Every heading keeps its
English id, fences match the English byte for byte, terms follow the
glossary's ja column, and each page carries a --stamp.

check-translations: ja 0 stale, 79 missing (was 98).

Fixes #386

Claude-Session: https://claude.ai/code/session_01QsR2jRsjbApbf83iyTDDXm

Co-Authored-By: Claude <noreply@anthropic.com>
Phase 2 of the other-locale plan, first batch: ja for the build/ top
level (index, agents, ai-builder, ai-skills, extend-existing-systems,
marketplace, packages, reports, templates) and build/data/ (index,
relationships, formulas, validation-rules). Same rules as #386: English
heading ids, fences byte for byte, glossary ja column, UI labels in
English, one line per paragraph, each page stamped.

check-translations: ja 0 stale, 66 missing (was 79).

Refs #388

Claude-Session: https://claude.ai/code/session_01QsR2jRsjbApbf83iyTDDXm

Co-Authored-By: Claude <noreply@anthropic.com>
@zhuangjianguo zhuangjianguo self-assigned this Oct 29, 2026
@objectstack-fleet

Copy link
Copy Markdown
Contributor

席位核对 · ACCEPT · 2026-10-29T10:49Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main a3e5657, head e897011. 13 added locale files, +2024/−0, under the 3000-line limit. This is PR 1 of 7 for Other locales, phase 2: ja to full coverage (the remaining 79 pages, seven serial PRs) #388, and the body says Refs #388. Claim 6494412087, branch claude/project-thread-u7eoxi. The changes stay within the claimed surface: build/ top level (9 pages) and build/data/* (4 pages). The head merges the already-merged docs(i18n): translate the entry path into ja (index, why, start, editions, use) #387 branch head only so that the push fast-forwards. The diff against main is exactly the 13 ja files, and the queue squashes it.
  2. Structure, seat check on all 13 pages. Heading counts match the English. Every ## keeps its English id, and the ids match the zh-Hans siblings one for one. Fenced code is byte-identical to the English. build/meta.ja.json and build/data/meta.ja.json already have pages equal to the English, so no meta change is needed.
  3. Terms. アクション is used for the ObjectStack action (9× in agents, 11× in ai-builder), matching the glossary's ja column (docs(i18n): add action and operation to the translation glossary #381). Product nouns stay English, for example AI Builder.
  4. Gates, seat re-run at e897011.
    • check-translations: ja 0 stale, 66 missing (was 0 and 79). zh-Hans stays at 0/0.
    • check-translation-output --files: passed, 0 findings.
    • Check-runs: Ownership & freshness success · Node floor success · build must pass in the queue.
    • The dev's browser check of /ja/docs/build/packages, /build/ai-builder, /build/data/relationships and /build/data/validation-rules showed ja content and the ja sidebar, with no page errors.
  5. Landing. Tier none. This is phase 2 of the maintainer-approved locale plan. It lands through the merge queue under the standing go-ahead, serially. PR 2 of 7 opens only after this one is green on main, smoke included.

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.

1 participant