Skip to content

docs(i18n): translate resources/ into ja, completing ja coverage (#388, PR 7 of 7) - #402

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

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

Conversation

@zhuangjianguo

Copy link
Copy Markdown
Collaborator

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

维护者速读

What changes

Files Change
content/docs/resources/{changelog,faq,glossary,support}.ja.mdx New ja translations

resources/meta.ja.json already matches the English pages list. Same rules as PRs 1–6 (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,430 lines.

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

Tests

Measured on PR 6's tree plus these 4 files, which is the same tree as main 68921f9 plus this commit, with a NEXT_PRIVATE_STANDALONE=true build:

  • Worker upload (wrangler deploy --dry-run): 43,949.36 KiB (gzip 8,565.28), against the 61,440 KiB budget, leaving 17,491 KiB. PR 6 measured 43,262.29 KiB the same way; these 4 pages add about 687 KiB (the changelog is long). Each translated page adds about 172 KiB to the Worker upload, so full ja coverage (#388) would exceed Cloudflare's 64 MiB Worker limit #395 projected full ja at 43,699 KiB with English stand-ins.
  • Per-page table on this build: ja 98 pages at 79.14 KiB per page.
  • check-translations.mjs: passed; ja 0 stale, 0 missing (was 4). zh-Hans stays 0/0.
  • check-translation-output.mjs --files <list of these 4>: blocking on 4, no findings.
  • check-locale-surface.mjs: passes.
  • check-search-locales.mjs: all 8 locales answer 200, find their own pages by title and find nothing for a nonce.
  • check-search-heap.mjs: every locale asked twice; the heap stayed under 100 MB and stopped growing.
  • Rendered check (Playwright against next start of this build): /ja/docs/resources/faq, /changelog, /glossary and /support answer 200 with lang="ja", ja titles (よくある質問, 変更履歴とバージョン管理, 用語集, サポート), the ja sidebar, English heading ids (getting-started, versioning-policy, action, where-to-go-for-what) and 0 page or console errors. Bold, links and blockquotes in the changelog were checked against the parsed Markdown: no emphasis is left unparsed.

Acceptance notes


Generated by Claude Code

zhuangjianguo and others added 21 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>
… PR 7 of 7)

Adds ja translations for the 4 resources/ pages: changelog, faq,
glossary and support. resources/meta.ja.json already matches the
English pages list. Same rules as the earlier batches.

With this batch every English page has a ja translation.
check-translations: ja 0 stale, 0 missing (was 4).

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

  1. Shape. Draft PR against main 68921f9, head 4b48d10. 4 added ja files, +734/−0. This is PR 7 of 7 for Other locales, phase 2: ja to full coverage (the remaining 79 pages, seven serial PRs) #388, and the body says Fixes #388. Claim 6494412087, branch claude/project-thread-u7eoxi. The changes stay within the claimed surface: resources/{changelog,faq,glossary,support}. resources/meta.ja.json already has pages equal to the English. The line count is lower than the English because ja paragraphs are one line each, the convention since phase 1.
  2. Structure, seat check on all 4 pages. Heading counts match the English: 23 in changelog, 47 in faq, 42 in glossary, 6 in support. 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. Terms. The glossary's own entry reads アクション(Action) [#action], matching docs/TRANSLATION.md's ja column (docs(i18n): add action and operation to the translation glossary #381).
  4. Gates, seat re-run at 4b48d10.
    • check-translations: ja 0 stale, 0 missing, and zh-Hans 0/0. ja is fully covered.
    • check-translation-output --files with a list file: blocking on 4 changed translations, passed, 0 findings.
    • Check-runs: Ownership & freshness success · Node floor success · build must pass, including the Worker budget step and both search gates.
  5. The dev's evidence on the identical tree. With full ja, the Worker upload is 43,949 KiB, with 17,491 KiB of headroom under the budget. check-search-locales passes in all 8 locales. check-search-heap stays under 100 MB and stops growing. The rendered check of all 4 pages shows ja content and no errors.
  6. Landing. Tier none. It enters the merge queue only after docs(i18n): translate reference/, architecture and ontology into ja (#388, PR 6 of 7) #401's main deploy shows a green smoke check. The two-week watch at ja 0 stale starts when it lands.

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

Other locales, phase 2: ja to full coverage (the remaining 79 pages, seven serial PRs)

1 participant