Skip to content

i18n-ja-release-8.5: translate doc changes from pingcap/docs release-8.5 on 2026-07-23#23339

Merged
qiancai merged 23 commits into
i18n-ja-release-8.5from
ja-translation/20260723-1784739832
Jul 23, 2026
Merged

i18n-ja-release-8.5: translate doc changes from pingcap/docs release-8.5 on 2026-07-23#23339
qiancai merged 23 commits into
i18n-ja-release-8.5from
ja-translation/20260723-1784739832

Conversation

@github-actions

@github-actions github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

What is changed, added or deleted? (Required)

Translate documentation changes from pingcap/docs release-8.5 to Japanese via ai-markdown-translator commit-diff sync.

English commit diff:

37c45d5...b6f7f75

Which TiDB version(s) do your changes apply to? (Required)

  • i18n-ja-release-8.5

What is the related PR or file link(s)?

  • Source repo: pingcap/docs
  • Source branch: release-8.5
  • TOCs: TOC.md,TOC-ai.md,TOC-api.md,TOC-best-practices.md,TOC-develop.md,TOC-tidb-releases.md,TOC-tidb-cloud.md,TOC-tidb-cloud-starter.md,TOC-tidb-cloud-essential.md,TOC-tidb-cloud-premium.md,TOC-tidb-cloud-releases.md
  • Source files: TOC-tidb-cloud-essential.md,TOC-tidb-cloud-premium.md,TOC-tidb-cloud-releases.md,ai/guides/vector-search-full-text-search-sql.md,best-practices/tidb-best-practices.md,index-advisor.md,sql-statements/sql-statement-cancel-distribution-job.md,sql-statements/sql-statement-distribute-table.md,sql-statements/sql-statement-show-distribution-jobs.md,sql-statements/sql-statement-show-table-distribution.md,statistics.md,sync-diff-inspector/sync-diff-inspector-overview.md,system-variables.md,tidb-cloud/architecture-concepts.md,tidb-cloud/backup-and-restore-concepts.md,tidb-cloud/manage-projects-and-resources.md,tidb-cloud/manage-user-access.md,tidb-cloud/premium/backup-and-restore-premium.md,tidb-cloud/releases/_index.md,tidb-cloud/releases/tidb-cloud-kernel-versioning.md,tidb-cloud/releases/tidb-cloud-release-notes.md,tidb-cloud/releases/tidb-x-cloud.202510.1.md,tidb-cloud/select-cluster-tier.md,tidb-cloud/tidb-cloud-intro.md,tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md,tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md,troubleshoot-tidb-oom.md
  • Sync outcome: failure

Translation failures

The following files were not translated automatically and must be handled manually before merging.

  • tidb-cloud/tidb-cloud-intro.md: structure-preserving reconciliation declined tidb-cloud/tidb-cloud-intro.md

Docs with document structure mismatches after translation

The following files were translated, but their Markdown heading or CustomContent structure does not match the source HEAD file.

  • sync-diff-inspector/sync-diff-inspector-overview.md: heading level sequence differs
    • Source: #x1 ##x6 ###x6 ##x1
    • Target: #x1 ##x6 ###x6 ##x2
    • First difference: heading 15: source (missing), target ##

Before merging this PR, manually translate the failed files above or rerun this workflow with workflow_dispatch and file_names set to those paths.

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

@github-actions github-actions Bot added the translation/no-need No need to translate this PR. label Jul 22, 2026
@ti-chi-bot

ti-chi-bot Bot commented Jul 22, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign overvenus for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot Bot added contribution This PR is from a community contributor. needs-ok-to-test Indicates a PR created by contributors and need ORG member send '/ok-to-test' to start testing. labels Jul 22, 2026
@ti-chi-bot

ti-chi-bot Bot commented Jul 22, 2026

Copy link
Copy Markdown

Hi @github-actions[bot]. Thanks for your PR.

I'm waiting for a pingcap member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@ti-chi-bot ti-chi-bot Bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Jul 22, 2026
qiancai and others added 7 commits July 23, 2026 08:01
Within vector-search-full-text-search-sql.md the English "full-text index"
was rendered both as 全文インデックス (5) and 全文検索インデックス (3).
The English term is "full-text index" (no "search"), so unify on
全文インデックス, matching 全文検索 = "full-text search".

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
In information retrieval, "term" refers to a word/token, not a
mathematical term (項). Use 単語頻度, which parallels 文書頻度
(document frequency) used in the same document. Abbreviation TF is kept.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
"receives twice the weight contribution" was translated with the stiff
2倍の重みの寄与を受けます; reword to 2倍の重みが与えられます for readability.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Use インデックス列 (index column) instead of the transliterated
インデックス フィールド for more natural RDB Japanese.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add は after [TiDB Cloud] (subject, "TiDB Cloud is ...") and を after
[TiDB] (object, "brings TiDB to your cloud"); also remove the stray space.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The English "your resources" dropped the possessive; add ご利用の to
clarify these are the user's provisioned TiDB Cloud resources.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the ja-translation/20260723-1784739832 branch from 24c1058 to 568644d Compare July 23, 2026 00:26
yahonda and others added 6 commits July 23, 2026 09:28
The kernel version format is TiDB-X-CLOUD.YYYYMM.x (year-month), so
"time-based" should be 日付ベース (date-based), not 時刻ベース (clock time).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The ja docs consistently render "release notes" link text as リリースノート
(769 vs 0). Translate the two links in tidb-cloud-kernel-versioning.md to
match; product names TiDB Cloud Premium / TiDB Self-Managed stay in English.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
"classic" is a common adjective here (lowercase mid-sentence in the source,
32 lowercase vs 3 capitalized docs-wide), not a proper noun, so translate it
to 従来の, matching the established ja convention (22 occurrences).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The linked page's visible ja heading is "TiDB Xアーキテクチャ", and this file
renders "architecture" as アーキテクチャ everywhere else; align the link text.
"TiDB X" stays in English.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- "Now you can use ..." reworded to ...確認できるようになりました (release-note
  style) instead of the stiff sentence-initial これで、.
- "[documentation]" link text translated to [ドキュメント], matching the ja
  convention (298 occurrences vs 0 kept in English).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Align link texts with the linked pages' Japanese titles:
- [Limited SQL features on TiDB X Instances] -> [TiDB X インスタンスで制限される SQL 機能]
- [Dual-Layer Data Encryption] -> [二重層データ暗号化]
Feature names (Top RU, Top SQL, Follower Read), product names, GitHub handles,
version numbers, tool names, and the PREVIEW badge are kept in English.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the ja-translation/20260723-1784739832 branch from 66c214b to 6efedeb Compare July 23, 2026 00:46
…English

Standardize general prose on コントロールプレーン / データプレーン (non-spaced
katakana). The bold feature-name labels that appear in the web console
(Customer-owned data plane, TiDB Cloud control plane, BYOC data plane) are
kept in English because they mirror untranslatable UI screen labels.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the ja-translation/20260723-1784739832 branch from e9eb85f to d0fa178 Compare July 23, 2026 00:50
yahonda and others added 6 commits July 23, 2026 09:53
Match the established ja convention (205 katakana vs 14 English). Note
peering is ピアリング, not ペアリング (pairing).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add を after the [二重層データ暗号化] link in two places: を有効にして
("enable ...") and を参照してください ("see ...").

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- "hypothetical indexes" was rendered as 仮説的な指標 (指標 = metric) in the
  heading and intro link; correct to 仮説インデックス, matching the same file's
  existing usage. Heading text only; {#hypothetical-indexes} anchor kept.
- Remove the [クエリヒント](/optimizer-hints.md) link that the MT inserted in
  L195; the English source has no such reference.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Top RU is a feature name kept in English (matching the release notes body);
revert the two remaining [トップRU] TOC links to [Top RU]. The PREVIEW badge
stays as-is.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yahonda

yahonda commented Jul 23, 2026

Copy link
Copy Markdown
Member

Review note: missing translation in tidb-cloud/tidb-cloud-intro.md

While reviewing this sync against the English diff (37c45d5...b6f7f75), I found one content gap.

The English tidb-cloud/tidb-cloud-intro.md adds two <CustomContent plan="byoc"> blocks (a BYOC intro paragraph and a BYOC architecture note), but the ja version in this PR does not include them (EN: 167 lines / ja: 149 lines, 2 BYOC blocks vs 0).

For reference, tidb-cloud/architecture-concepts.md does have its ## TiDB Cloud BYOC section translated in this branch, so the omission in tidb-cloud-intro.md looks inconsistent rather than a blanket "BYOC is out of ja scope" skip — though it may still be intentional (BYOC is in private preview).

Missing English blocks:

<CustomContent plan="byoc">

    {{{ .byoc }}} is designed for large-scale production workloads that require greater control, security, and compliance. It enables you to run the data plane in your own AWS account while benefiting from TiDB Cloud's automated operations, elastic scalability, and enterprise-grade security.

    Currently, {{{ .byoc }}} is in private preview on AWS.

</CustomContent>

<CustomContent plan="byoc">

> **Note:**
>
> TiDB Cloud BYOC uses a different architecture from other TiDB Cloud deployment options. In BYOC, the TiDB Cloud control plane is managed by PingCAP, while the data plane runs in your own cloud account. For details, see the [TiDB Cloud BYOC architecture](/tidb-cloud/architecture-concepts.md#tidb-cloud-byoc).

</CustomContent>

All other 25 translated files match the new English structure 1:1, and the remaining English-changed files (.agents/*, tidb-cloud-lake/*, tidb-cloud/byoc/*, TOC-tidb-cloud-byoc.md, TOC-tidb-cloud-lake.md) are not part of the ja doc set, so they are correctly untranslated.

@qiancai

qiancai commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

tidb-cloud/tidb-cloud-intro.md

@yahonda The "tidb-cloud/tidb-cloud-intro.md" was added in f9f521c.

yahonda and others added 2 commits July 23, 2026 13:28
The retranslated BYOC block left "security" in English; use セキュリティ to
match the same file's existing usage (enterprise-grade セキュリティ) and the
lowercase common-noun source.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Match the file's own アーキテクチャ usage and the established convention;
"TiDB Cloud BYOC" (product name) stays in English, only "architecture" is
translated. The link target is unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ti-chi-bot

ti-chi-bot Bot commented Jul 23, 2026

Copy link
Copy Markdown

@yahonda: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@qiancai qiancai removed the needs-ok-to-test Indicates a PR created by contributors and need ORG member send '/ok-to-test' to start testing. label Jul 23, 2026
@qiancai
qiancai merged commit f124974 into i18n-ja-release-8.5 Jul 23, 2026
3 of 8 checks passed
@qiancai
qiancai deleted the ja-translation/20260723-1784739832 branch July 23, 2026 05:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution This PR is from a community contributor. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. translation/no-need No need to translate this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants