Skip to content

docs(i18n): translate reference/, architecture and ontology into ja (#388, PR 6 of 7) - #401

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

zhuangjianguo merged 19 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

维护者速读

  • 改了什么:新增 reference/ 下 9 个日文页面,以及根目录的 architecture、ontology 两个日文页面。
  • 为什么改:Other locales, phase 2: ja to full coverage (the remaining 79 pages, seven serial PRs) #388 第 6 批。
  • 风险与回滚:只加 11 个 locale 文件。Worker 上传约 42,253 → 43,262 KiB(本地),预算 61,440 KiB。回滚即 revert 本 PR。
  • 先看:CI step summary 中 Worker bundle fits the size budget 的「Per-page cost」表。
  • 两分钟验证:打开 /ja/docs/architecture 和 /ja/docs/reference/cel,正文为日文;侧边栏中「Architecture」「Your ontology in ObjectOS」变为日文标题。
  • 需要你做的:无,席位落地。

What changes

Files Change
content/docs/reference/{cel,cli,environment-variables,field-types,objectql,rest-api,runtime-capabilities,security,skills-cli}.ja.mdx New ja translations
content/docs/{architecture,ontology}.ja.mdx New ja translations

reference/meta.ja.json already matches the English pages list. The root sidebar has only meta.json (shared by every locale), so nothing to add there. Same rules as PRs 1–5 (docs/TRANSLATION.md): English heading ids, fences byte for byte, glossary ja column, UI labels in English, one line per paragraph, each page stamped. English source: about 1,740 lines.

The branch carries one -s ours merge of the landed #400 branch head so the push fast-forwards; the diff against main is only these 11 files.

Tests

Measured on #400's head c74c76a plus these 11 files, which is the same tree as main 7e13146 plus this commit, with a NEXT_PRIVATE_STANDALONE=true build:

  • Worker upload (wrangler deploy --dry-run): 43,262.29 KiB (gzip 8,426.59), against the 61,440 KiB budget. PR 5 measured 42,252.54 KiB the same way, so these 11 pages add about 1,010 KiB, 92 KiB each.
  • Per-page table on this build: ja 94 pages at 75.70 KiB per page.
  • check-translations.mjs: passed; ja 0 stale, 4 missing (was 15).
  • check-translation-output.mjs --files <list of these 11>: blocking on 11, no findings.
  • check-locale-surface.mjs: passes.
  • Rendered check (Playwright against next start of this build): /ja/docs/architecture, /ja/docs/ontology and /ja/docs/reference/cel answer 200 with lang="ja", ja titles (アーキテクチャ, ObjectOS におけるあなたのオントロジー, CEL 式), the ja sidebar, English heading ids (what-you-deploy, the-core, where-objectos-uses-it) and 0 page or console errors. reference/ has no index page in English either, so /ja/docs/reference is a 404 just like /docs/reference.

Acceptance notes


Generated by Claude Code

zhuangjianguo and others added 19 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>
…388, PR 2 of 7)

Adds ja translations for the 11 automation and interface pages:
build/automation/{index,flows,workflows,approvals} and
build/interface/{index,apps,views,forms,dashboards,pages,actions}.
Both sections' meta.ja.json already match the English pages list.

Refs #388

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

Co-Authored-By: Claude <noreply@anthropic.com>
…tput (#393)

/api/search kept every locale's Orama index (30-40 MB each) and every
page module page.data.load() imported, so one Worker isolate grew from
58 MB after its first locale to 283 MB after all eight, and #390's ja
pages tipped it past 128 MB into 503s.

- scripts/gen-search-data.mjs computes each page's structuredData before
  next build with fumadocs-mdx's own remark chain and writes one gzipped
  module per locale to apps/docs/.search/; the route reads that instead
  of importing page modules.
- The route keeps the most recently used locale's index only.
- check-search-heap.mjs asks the built route in every locale twice and
  fails above 100 MB or when the second pass keeps growing; it runs in
  ci.yml after check-search-locales and its --self-test is in SELF_TESTED.

Measured on the built route: levels at 50-54 MB across both passes.

Fixes #393

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

Co-Authored-By: Claude <noreply@anthropic.com>
The tree is unchanged: the diff against main is the #393 commit only.

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

Co-Authored-By: Claude <noreply@anthropic.com>
…388, PR 2 of 7)

Reverts #392, which reverted #390 because /api/search ran out of Worker
memory. #394 (#393) fixed that, so the same 11 ja pages come back
unchanged.

Refs #388

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

Co-Authored-By: Claude <noreply@anthropic.com>
The tree is unchanged: the diff against main is the re-landed ja pages only.

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

Co-Authored-By: Claude <noreply@anthropic.com>
Six route handlers (search, og, sitemap, llms.txt, llms-full.txt,
llms.mdx) import lib/source.ts, whose fumadocs-mdx collection holds a
lazy import() of every compiled page. Turbopack compiles route handlers
as their own module graph, so the Worker carried a second copy of every
page module: ~20 MB of upload, and each translated page cost ~170-235 KiB
instead of ~86. #388's PR 3 would have gone over the 61,440 KiB budget.

- scripts/gen-route-data.mjs (was gen-search-data.mjs) also writes
  .route-data/collection.ts: .source/server.ts with each page's body
  import replaced by a read of generated data, and markdown.ts, the
  English pages' processed Markdown the llms routes serve. With --dev it
  re-exports the full collection so next dev sees new pages.
- lib/source.ts builds its loader on that collection; the page route
  loads bodies through lib/page-body.ts, the only module that imports
  the full collection.
- lib/packed.ts unpacks the generated gzip+base64 strings.
- The Worker budget step prints a per-page projection from the bundle's
  metafile (check-worker-page-cost.mjs, in SELF_TESTED).

Measured, same machine: main f7e4a57 59,173 KiB, this change 38,909 KiB;
with every ja page filled in, 43,700 KiB.

Fixes #395

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

Co-Authored-By: Claude <noreply@anthropic.com>
The tree is unchanged: the diff against main is the #395 commit only.

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

Co-Authored-By: Claude <noreply@anthropic.com>
Adds ja translations for the 14 configure/ pages: index, ai, api-access,
authentication, data-sources, email, localization, mcp, notifications,
runtime, storage, system-settings, users and webhooks. configure/
meta.ja.json already matches the English pages list. Same rules as the
earlier batches: 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, 41 missing (was 55).

Refs #388

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

Co-Authored-By: Claude <noreply@anthropic.com>
… PR 4 of 7)

Adds ja translations for the 7 configure/permissions/ pages (index,
managing-access, permission-sets, positions, record-access,
field-level-security, hierarchy-visibility) and the 8 cloud/ pages
(organization, environments, plans-and-seats, ai-credits-and-limits,
storage-and-limits, domains, apps, cloud-connection), plus a new
cloud/meta.ja.json whose pages match the English. configure/permissions/
meta.ja.json already matched. Same rules as the earlier batches.

check-translations: ja 0 stale, 26 missing (was 41).

Refs #388

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

Co-Authored-By: Claude <noreply@anthropic.com>
Adds ja translations for the 4 deploy/ pages (index, docker, kubernetes,
air-gapped) and the 7 operate/ pages. Both sections' meta.ja.json
already match the English pages list. Same rules as the earlier batches.

check-translations: ja 0 stale, 15 missing (was 26).

Refs #388

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

Co-Authored-By: Claude <noreply@anthropic.com>
…388, PR 6 of 7)

Adds ja translations for the 9 reference/ pages and the two root pages,
architecture and ontology. reference/meta.ja.json already matches the
English pages list; the root sidebar has only meta.json. Same rules as
the earlier batches.

check-translations: ja 0 stale, 4 missing (was 15).

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-29T13:58Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main 7e13146, head 3df88d4. 11 added ja files, +1362/−0, under the 3000-line limit. This is PR 6 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: reference/* (9) and root architecture and ontology. reference/meta.ja.json already has pages equal to the English. The root sidebar has only the shared meta.json, as for every locale.
  2. Structure, seat check on all 11 pages. Heading counts match the English, including the 21 headings in reference/cli and the 19 in reference/security. Every heading keeps its English id, and the ids match the zh-Hans siblings one for one. Fenced code is byte-identical to the English.
  3. Gates, seat re-run at 3df88d4.
    • check-translations: ja 0 stale, 4 missing (was 0 and 15). zh-Hans stays at 0/0.
    • check-translation-output --files with a list file: blocking on 11 changed translations, passed, 0 findings.
    • Check-runs: Ownership & freshness success · Node floor success · build must pass, including the Worker budget step.
  4. The dev's evidence. The Worker upload is 43,262 KiB, +1,010 KiB. The rendered check of /ja/docs/architecture, /ontology and /reference/cel shows ja content, the ja sidebar and no errors.
  5. Landing. Tier none. It enters the merge queue only after docs(i18n): translate deploy/ and operate/ into ja (#388, PR 5 of 7) #400's main deploy shows a green smoke check, serially.

@zhuangjianguo
zhuangjianguo marked this pull request as ready for review October 29, 2026 14:04
@zhuangjianguo
zhuangjianguo added this pull request to the merge queue Oct 29, 2026
Merged via the queue into main with commit 68921f9 Oct 29, 2026
4 checks passed
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