Skip to content

i18n(ja): fix TiDB Cloud docs (architecture to import) found in the second full review - #24565

Open
yahonda wants to merge 18 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-fix-tidb-cloud-top-a-2nd-review
Open

yahonda wants to merge 18 commits into
pingcap:i18n-ja-release-8.5from
yahonda:i18n-ja-fix-tidb-cloud-top-a-2nd-review

Conversation

@yahonda

@yahonda yahonda commented Oct 28, 2026 •

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

This PR fixes the Japanese TiDB Cloud docs from ai-feature-concepts.md to connect-to-tidb-cluster-serverless.md (alphabetical), plus essential-changefeed-sink-to-kafka.md. The fixes come from a second line-by-line review against the English source (release-8.5 at 6fa2484). The review covered 24 files, and 21 of them needed changes. Code blocks, commands, URLs, and link targets are unchanged.

  • Mistranslations:
    • "ACL authorization" was 「ACL認証」 (authentication). It is now 「ACL認可」.
    • "auto-backups with a lifetime within the retention period" was 「保持期間内に有効期限が設定されている自動バックアップ」.
    • "authorize the TiDB Cloud Branching app" was 「認証」.
    • "data distribution" and "distribution method" were 「配信」.
    • In the Split Event link text, the object of 「分割」 was misplaced.
    • The architecture pricing lines dropped "storage" from the first item and added it to the second.
    • 「メンテナンス期間」 is now 「メンテナンスウィンドウ」 (maintenance window), and 「ポイントインタイムリストア」 is now 「ポイントインタイム復元」.
  • Bold UI labels that had been translated are restored to English, for example Buckets, Options, Require external ID (...), CREATE, Custom deployment, Security+network, List, Backup Setting, Date, Time, Ignore update new/old value expression, and the Pulsar dispatcher options.
  • Leftover English is translated: "Request Units", "Replication Capacity Units (RCUs)", "access key", "observability", "data-plane", and "Firewall".
  • One rendering per term:
    • spending limit → 支出限度額 (was 利用限度額, 利用制限, and 支出制限)
    • role → ロール (was 役割), public endpoint → パブリックエンドポイント
    • 「ステップ N. 」 step headings with a half-width period
  • cli-reference.md: the command table now matches the English (spending-limit, config, help), and option separators use a comma as in the English.
  • Notation: spaces inside katakana compounds (for example 「バックアップ スケジュール」) are removed, and backticks that the English does not use in the tidb_gc_life_time link texts are removed.
  • Anchors: the stale -beta anchors of branch-overview.md and cli-reference.md now match the English (PREVIEW) headings. No page links to the old anchors.

Update (2026-10-29): parts 5 and 6 added after sync #24577 merged

This PR now also covers the files from connect-to-tidb-cluster.md to import-parquet-files.md (alphabetical; 42 files). They were held until #24577, because the Chat2Query removal (#24549) rewrote many of their lines. Each finding was re-checked against the current English (aae0e91) before it was applied.

  • Mistranslations: reversed or broken sentences in data-service-manage-endpoint.md, connected-care-overview.md (「異なる異なるプラン」), csv-config-for-import-data.md, essential-changefeed-overview.md (the configuration is pre-populated), essential-changefeed-sink-to-mysql.md (「はいの場合」), and database-schema-concepts.md.
  • Bold UI labels restored to English, for example Timeout(ms), Time-to-live(s), the Google Cloud console labels in dedicated-external-storage.md, the Kafka distribution and dispatcher options, Filter results with/without valid keys, and Use File naming conventions for automatic mapping in the four import guides.
  • One rendering per term: spending limit → 支出限度額 (including create-tidb-cluster-serverless.md), reseller → 販売代理店 (cppo-customer.md and the six TOC entries), role → ロール, public/private key → 公開鍵/秘密鍵, log redaction → ログの秘匿化, Region → リージョン, (Optional) → (オプション), and headings in the 「〜する」 form. Anchors are unchanged.
  • Link texts now copy the target pages' Japanese H1s, including the TOC entries for the renamed endpoint page.
  • Markup: nested mailto links in the Connected Care pages, a full-width a., and spaces inside katakana compounds.

Update (2026-10-30): term sweeps

  • Zonal and regional high availability are now ゾーン高可用性 and リージョン高可用性, as defined in serverless-high-availability.md: architecture-concepts.md (was ゾーン型高可用性, 地域別高可用性, and 地域的な高可用性), byoc/create-tidb-instance-byoc.md, byoc/manage-resource-pools-byoc.md (was ゾーナル/リージョナル高可用性), and premium/create-tidb-instance-premium.md (was リージョンごとの高可用性).

  • Interactive mode → 対話型モード and non-interactive mode → 非対話型モード (was 対話モード / 非対話モード), matching the majority form in the ticloud reference pages (8 sites in one file).

  • Redundant can-form: 「〜することができます」 → 「〜できます」 (for example 設定することができます → 設定できます, 有効にすることができます → 有効にできます). Other conjugations are changed the same way (することができ、 → でき、, することができません → できません, することができました → できました, and so on). 「〜することもできます」 and 「〜することはできません」 are kept. Text inside code is not changed.

  • "maintenance window" now uses one term, メンテナンスウィンドウ (was also メンテナンス期間, メンテナンス時間, and メンテナンス時間帯).

  • Spaces between katakana words, left over from machine translation, are removed outside code (for example パフォーマンス テスト → パフォーマンステスト, アクセス リスト → アクセスリスト). Spaces between Latin and Japanese text are not changed.

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

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • i18n-ja-release-8.5 (TiDB Japanese documentation for TiDB 8.5 versions)

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

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

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

🤖 Generated with Claude Code

Summary by CodeRabbit

  • ドキュメント
    • TiDB Cloudの日本語ドキュメントで、支出限度額やリクエストユニットなどの用語と表記を統一しました。
    • バックアップと復元、ブランチ管理、メンテナンスウィンドウ、ネットワーク接続、Changefeedの案内を更新しました。
    • CLI、クラウドサービスのコンソール項目、データインポート、Data Serviceなどの手順や説明を見直しました。

@ti-chi-bot

ti-chi-bot Bot commented Oct 28, 2026

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@ti-chi-bot ti-chi-bot Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 28, 2026
@ti-chi-bot

ti-chi-bot Bot commented Oct 28, 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 kissmydb 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

@coderabbitai

coderabbitai Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
Walkthrough

TiDB Cloudの日本語ドキュメントで、用語、UIラベル、見出し、リンク表示、説明文を更新しました。一部の説明文も変更しました。多くの手順や設定条件の記載は維持されています。

Changes: TiDB Cloud ドキュメント

Layer / File(s) Summary
アーキテクチャとリソース用語
tidb-cloud/architecture-concepts.md, tidb-cloud/calibrate-resource.md, tidb-cloud/features.md, tidb-cloud/database-schema-concepts.md, tidb-cloud/data-streaming-concepts.md
RUやRCUの表記、料金説明、BYOC構成、データベーススキーマなどの用語と説明を更新しました。
バックアップと復元
tidb-cloud/backup-and-restore*.md, tidb-cloud/import-csv-files.md, tidb-cloud/import-parquet-files.md
「リストア」を「復元」に変更し、支出限度額やUIラベルなどの表記を更新しました。自動バックアップの説明から、有効期限の条件を削除しました。
ブランチングとGitHub連携
tidb-cloud/branch-*.md
見出し、支出限度額、GitHubアプリの承認手順などの文言を更新しました。
Changefeedの用語と設定説明
tidb-cloud/changefeed-*.md, tidb-cloud/essential-changefeed-*.md
ACLの用語、UIラベル、ネットワーク方式、イベントフィルターなどの表記を更新しました。
CLIリファレンス
tidb-cloud/cli-reference.md
コマンド名、サブコマンド名、見出し、フラグ表の表記を更新しました。
外部ストレージ接続手順
tidb-cloud/configure-external-storage-access.md, tidb-cloud/dedicated-external-storage.md
各クラウドのコンソールラベルと資格情報の表記を更新しました。
クラスター設定と接続
tidb-cloud/configure-*.md, tidb-cloud/connect-to-tidb-cluster*.md
ファイアウォール、メンテナンスウィンドウ、SQLユーザー、接続方法などの表記を更新しました。
Data Service
tidb-cloud/data-service-*.md
APIキー、エンドポイント、連携手順の用語、UI名、リンク表示、説明文を更新しました。
Data PipelineとLake
tidb-cloud/data-pipeline-*.md
外部ステージとLake向け手順の表記を更新し、命名規則の説明項目の配置を調整しました。
CSV・Parquetインポート
tidb-cloud/import-csv-files*.md, tidb-cloud/import-parquet-files*.md, tidb-cloud/csv-config-for-import-data.md
インポート手順のUI名、マッピング表記、見出し、説明文を更新しました。
サポート情報と目次
tidb-cloud/connected-*.md, tidb-cloud/cppo-customer.md, TOC-tidb-cloud*.md
サポート情報、販売代理店の用語、目次項目の表示名を更新しました.

Priority: Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Suggested reviewers: qiancai

Merge Risk: Low · up to f35df

The procedure may confuse readers about where to enter the GCS URI; clarify the step before merging.

Pre-merge checks: Passed 4
Check name Status Explanation
Title check Passed The title names the i18n(ja) scope and the review-driven fix. The changeset does fix Japanese TiDB Cloud docs across many files, but the title's parenthetical "(architecture to import)" describes an a…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Description check Passed The pull request description is complete and follows the repository template. It explains the scope and purpose, identifies the affected version, provides the English reference source, records AI invo…
Full details: Title check

Explanation

The title names the i18n(ja) scope and the review-driven fix. The changeset does fix Japanese TiDB Cloud docs across many files, but the title's parenthetical "(architecture to import)" describes an alphabetical file range, not the main change. It also does not name the kinds of fixes (mistranslations, UI label restoration, terminology). The title is partially related: it refers to a real aspect of the change but is not specific about the main point.

Full details: Description check

Explanation

The pull request description is complete and follows the repository template. It explains the scope and purpose, identifies the affected version, provides the English reference source, records AI involvement, and addresses the listed change categories. The first-time contributor checklist is optional and may be omitted.

Finishing Touches: 💡 1
🛠️ Fix failing CI checks: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ti-chi-bot ti-chi-bot Bot added missing-translation-status This PR does not have translation status info. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Oct 28, 2026
@yahonda
yahonda marked this pull request as ready for review October 28, 2026 07:08
@ti-chi-bot ti-chi-bot Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 28, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1


Review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 1ab23c8 and dabd045.

Files selected for processing: 21
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/backup-and-restore-serverless.md
  • tidb-cloud/backup-and-restore.md
  • tidb-cloud/branch-github-integration.md
  • tidb-cloud/branch-manage.md
  • tidb-cloud/branch-overview.md
  • tidb-cloud/calibrate-resource.md
  • tidb-cloud/changefeed-overview.md
  • tidb-cloud/changefeed-sink-to-apache-kafka.md
  • tidb-cloud/changefeed-sink-to-apache-pulsar.md
  • tidb-cloud/changefeed-sink-to-cloud-storage.md
  • tidb-cloud/changefeed-sink-to-mysql.md
  • tidb-cloud/changefeed-sink-to-tidb-cloud.md
  • tidb-cloud/cli-reference.md
  • tidb-cloud/configure-external-storage-access.md
  • tidb-cloud/configure-ip-access-list.md
  • tidb-cloud/configure-maintenance-window.md
  • tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md
  • tidb-cloud/configure-sql-users.md
  • tidb-cloud/connect-to-tidb-cluster-serverless.md
  • tidb-cloud/essential-changefeed-sink-to-kafka.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 1 remain after this review.

Comment thread tidb-cloud/configure-external-storage-access.md
yahonda and others added 7 commits October 29, 2026 10:42
…found in the second full review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ture-concepts.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…hitecture-concepts.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…store-serverless.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…second full review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…econd full review

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… pages

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the i18n-ja-fix-tidb-cloud-top-a-2nd-review branch from dabd045 to 302c679 Compare October 29, 2026 01:52
@ti-chi-bot ti-chi-bot Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Oct 29, 2026
@yahonda yahonda changed the title i18n(ja): fix TiDB Cloud docs (architecture to essential changefeed) found in the second full review i18n(ja): fix TiDB Cloud docs (architecture to import) found in the second full review Oct 29, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3


Review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between dabd045 and 302c679.

Files selected for processing: 48
  • TOC-tidb-cloud-byoc.md
  • TOC-tidb-cloud-essential.md
  • TOC-tidb-cloud-premium.md
  • TOC-tidb-cloud-starter-postgresql.md
  • TOC-tidb-cloud-starter.md
  • TOC-tidb-cloud.md
  • tidb-cloud/changefeed-sink-to-cloud-storage.md
  • tidb-cloud/connect-to-tidb-cluster.md
  • tidb-cloud/connected-care-detail.md
  • tidb-cloud/connected-care-overview.md
  • tidb-cloud/connected-lark-ticket-creation.md
  • tidb-cloud/connected-lark-ticket-interaction.md
  • tidb-cloud/connected-slack-ticket-creation.md
  • tidb-cloud/connected-slack-ticket-interaction.md
  • tidb-cloud/cppo-customer.md
  • tidb-cloud/create-tidb-cluster-serverless.md
  • tidb-cloud/create-tidb-cluster.md
  • tidb-cloud/csv-config-for-import-data.md
  • tidb-cloud/data-pipeline-configure-external-stage-alibaba-cloud.md
  • tidb-cloud/data-pipeline-configure-external-stage-aws.md
  • tidb-cloud/data-pipeline-dedicated-sink-to-lake.md
  • tidb-cloud/data-pipeline-essential-sink-to-lake.md
  • tidb-cloud/data-pipeline-sink-to-lake.md
  • tidb-cloud/data-service-api-key.md
  • tidb-cloud/data-service-concepts.md
  • tidb-cloud/data-service-custom-domain.md
  • tidb-cloud/data-service-get-started.md
  • tidb-cloud/data-service-integrations.md
  • tidb-cloud/data-service-manage-data-app.md
  • tidb-cloud/data-service-manage-endpoint.md
  • tidb-cloud/data-service-manage-github-connection.md
  • tidb-cloud/data-service-oas-with-nextjs.md
  • tidb-cloud/data-service-overview.md
  • tidb-cloud/data-service-postman-integration.md
  • tidb-cloud/data-streaming-concepts.md
  • tidb-cloud/database-schema-concepts.md
  • tidb-cloud/dedicated-external-storage.md
  • tidb-cloud/delete-tidb-cluster.md
  • tidb-cloud/essential-changefeed-overview.md
  • tidb-cloud/essential-changefeed-sink-to-kafka.md
  • tidb-cloud/essential-changefeed-sink-to-mysql.md
  • tidb-cloud/essential-database-audit-logging.md
  • tidb-cloud/features.md
  • tidb-cloud/get-started-with-cli.md
  • tidb-cloud/import-csv-files-serverless.md
  • tidb-cloud/import-csv-files.md
  • tidb-cloud/import-parquet-files-serverless.md
  • tidb-cloud/import-parquet-files.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 2 remain after this review.

Comment thread tidb-cloud/cppo-customer.md Outdated
Comment thread tidb-cloud/data-service-api-key.md Outdated
Comment thread tidb-cloud/dedicated-external-storage.md Outdated
yahonda and others added 3 commits October 29, 2026 11:30
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…description

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…icated-external-storage.md

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1


Review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 302c679 and f35dff9.

Files selected for processing: 3
  • tidb-cloud/cppo-customer.md
  • tidb-cloud/data-service-api-key.md
  • tidb-cloud/dedicated-external-storage.md

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 1 remain after this review.

Comment thread tidb-cloud/dedicated-external-storage.md Outdated
yahonda and others added 2 commits October 29, 2026 11:37
…al-storage.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
yahonda and others added 6 commits October 29, 2026 14:36
…ages

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing-translation-status This PR does not have translation status info. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant