Skip to content

docs(i18n): translate the entry path into ja (index, why, start, editions, use) - #387

Merged
zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-u7eoxi
Oct 29, 2026
Merged

zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-u7eoxi

Conversation

@zhuangjianguo

Copy link
Copy Markdown
Collaborator

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

维护者速读

  • 改了什么:新增 19 个入口页面的日文译文(index、why、start/*、editions/*、use/*),以及 start/meta.ja.json、editions/meta.ja.json 两个日文侧栏标签。只新增译文文件,不动 en、zh-Hans、zh-Hant 和代码。
  • 为什么改:其他语言分阶段计划的第 1 阶段(2026-10-29 09:44Z 维护者同意):日文先覆盖入口路径,并纳入翻译例程。
  • 风险与回滚:只加 21 个 locale 文件;其余 79 个日文页面仍回退英文。回滚即 revert 本 PR,这些页面重新回退英文。
  • 先看:content/docs/start/cloud.ja.mdx(最短的完整页)和 content/docs/use/records.ja.mdx。
  • 两分钟验证:打开 /ja/docs/start/cloud,正文和侧栏「開始」「エディション」「使い方」都是日文;/ja/docs/start/community#path-b--os-init-developer 锚点仍可跳转。
  • 需要你做的:无,席位落地。

What changes

Files Change
content/docs/{index,why}.ja.mdx New ja translations
content/docs/start/{cloud,community,enterprise}.ja.mdx + start/meta.ja.json New ja translations; sidebar label 開始, pages equal to English
content/docs/editions/{compare,license,public-preview}.ja.mdx + editions/meta.ja.json New ja translations; sidebar label エディション, pages equal to English
content/docs/use/{index,approvals,collaboration,dashboards,files,import,notifications,profile,records,search,views}.ja.mdx New ja translations (use/meta.ja.json already existed)

Rules followed (docs/TRANSLATION.md): product nouns stay English; glossary ja column (action = アクション, operation = 操作); every heading keeps its English id (## 日本語 [#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 as in the zh-Hans corpus; each page stamped with check-translations.mjs --stamp. Paragraphs are one line each, because a soft line break between two Japanese characters renders as a visible space.

Tests

Content-only diff. Local gates on 4c93e10:

  • check-translations: ja 0 stale, 79 missing (was 98), 0 guide-stale; zh-Hans 0/0/0; gate passed.
  • check-translation-output --files <changed>: no findings (fence, url, frontmatter, component, unsafe, length).
  • check-translation-ownership --files <name-status>: 21 translation artifacts, 0 other files.
  • Every ja page parsed with mdast: no stray * left in text nodes (no broken CJK emphasis).
  • gen-zh-hant --check clean (115 files), check-doc-samples, turbo run type-check, build, test, check-locale-surface, check-positioning, check-search-locales all green.
  • Rendered with next start (playwright): /ja/docs, /ja/docs/start/cloud, /ja/docs/use/records, /ja/docs/start/community, /ja/docs/editions/license at desktop 1280, and /ja/docs, /ja/docs/use/records at mobile 390. All return 200 with html lang="ja", ja H1 and body, and the ja sidebar (開始, エディション, 使い方); no page or console errors.

Acceptance notes


Generated by Claude Code

…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>
@zhuangjianguo zhuangjianguo self-assigned this Oct 29, 2026
@objectstack-fleet

Copy link
Copy Markdown
Contributor

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

  1. Shape. Draft PR against main 64974cf, head 4c93e10. 21 added locale files, +1803/−0, under the 3000-line limit. The body says Fixes #386. Claim 6494021355, branch claude/project-thread-u7eoxi. The changes stay within the claimed surface: 19 *.ja.mdx files plus start/meta.ja.json and editions/meta.ja.json.
  2. Structure, seat check on all 19 pages. Heading counts match the English. Every ## keeps its English id. Fenced code is byte-identical to the English. The two new meta files have pages equal to the English.
  3. Terms. アクション is used for the ObjectStack action, for example 6× in use/records and 3× in index and why, matching the glossary's ja column (docs(i18n): add action and operation to the translation glossary #381). Product nouns stay English.
  4. Gates, seat re-run at 4c93e10.
    • check-translations: ja 0 stale, 79 missing (was 0 and 98). zh-Hans stays at 0/0.
    • check-translation-output --files: passed, 0 findings.
    • Check-runs: build success · Node floor success · Ownership & freshness success.
    • The dev's browser check of /ja/docs, /ja/docs/start/cloud and /ja/docs/use/records showed ja content and the ja sidebar, with no page errors.
  5. Routine. After landing, the seat's translation routine (Run the zh-Hans translation pass as a routine (on merge to main touching English pages, or weekly), stamped with --stamp, so coverage converges without a hand-run pass #379) also watches these 19 ja pages.
  6. Landing. Tier none. This is phase 1 of the maintainer-approved locale plan. It lands through the merge queue under the standing go-ahead, serially.

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 1: ja for the entry path (index, why, start, editions, use — 19 pages) and attach ja to the translation routine

1 participant