Skip to content

i18n(ja): remove spurious middle-dots from katakana compound terms - #23693

Merged
qiancai merged 9 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-katakana-middle-dot-sweep
Sep 2, 2026
Merged

i18n(ja): remove spurious middle-dots from katakana compound terms#23693
qiancai merged 9 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-katakana-middle-dot-sweep

Conversation

@yahonda

@yahonda yahonda commented Sep 2, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Middle-dot (・) was used to split many katakana technical compound terms that should be written as one continuous word, matching the standing katakana-compound-spacing convention (no separator between katakana words in a single term) and the same pattern already fixed for OLTP in PR #23692.

Examples: インデックス・ネストループインデックスネストループ (Index Nested Loop [Join]), プライマリ・セカンダリプライマリセカンダリ, アルター・リソース・グループアルターリソースグループ, データベース・アズ・ア・サービスデータベースアズアサービス (Database as a Service), ハイブリッド・トランザクション・アンド・アナリティカル・プロセッシングハイブリッドトランザクションアンドアナリティカルプロセッシング (HTAP full expansion).

Also found and fixed 2 GitHub-username mistransliterations where a middle-dot had been incorrectly inserted into a single username (release-6.5.6.md, release-7.1.3.md: CharlesCheung96, tonyxuqqi).

This was a mechanical, corpus-wide sweep (regex-based) — the user will do their own pass to catch any remaining false positives. Known categories already excluded/reviewed during this pass:

  • Foreign personal names, where middle-dot is the correct Japanese convention (e.g. "Ketanji Brown Jackson" in ai/integrations/vector-search-integrate-with-langchain.md — found by the mechanical sweep, verified as a real name, and reverted).
  • Middle-dot used as a genuine "and" list separator between two distinct EN-sourced actions/items (e.g. 構成・セットアップ = configure and set up, 開発・テスト = development and testing) — left untouched, these are correct Japanese.
  • 3 sites where EN explicitly uses "and" between two distinct actions (incremental backup and restore; backup and restore functions; merge and import) were reworded with と/および instead of silently joining into one compound, to preserve the "and" meaning.

40 files changed. See [[ja-katakana-middle-dot-broader-sweep]] memory note for the original scoping.

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

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

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

  • This PR is translated from:
  • Other reference 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

Summary by CodeRabbit

  • Documentation
    • Standardized Japanese terminology, punctuation, spacing, and transliterations across guides, FAQs, glossaries, release notes, and TiDB Cloud documentation.
    • Clarified wording for HTAP, OLTP/OLAP, backup and restore, disaster recovery, resource groups, optimizer hints, benchmark procedures, and migration topics.
    • Corrected contributor attributions and updated a license link label.
    • No functional behavior, procedures, commands, or technical content changed.

Middle-dot (・) was used to split many katakana technical compound
terms that should be written as one continuous word, matching the
standing katakana-compound-spacing convention (no separator between
katakana words in a single term) and the same pattern already fixed
for OLTP in PR pingcap#23692. Examples: インデックス・ネストループ →
インデックスネストループ (Index Nested Loop [Join]), プライマリ・
セカンダリ → プライマリセカンダリ, アルター・リソース・グループ →
アルターリソースグループ, データベース・アズ・ア・サービス →
データベースアズアサービス (Database as a Service).

Also found and fixed 2 GitHub-username mistransliterations where a
middle-dot had been incorrectly inserted into a single username
(release-6.5.6.md, release-7.1.3.md: CharlesCheung96, tonyxuqqi).

Left untouched (verified false positives / legitimate uses):
- Foreign personal names, where middle-dot is the correct Japanese
  convention (e.g. Ketanji Brown Jackson in
  ai/integrations/vector-search-integrate-with-langchain.md).
- Middle-dot used as a genuine 'and' list separator between two
  distinct EN-sourced actions/items (e.g. 構成・セットアップ =
  configure and set up, 開発・テスト = development and testing) —
  these are correct Japanese and not part of this defect class.
- 3 sites where EN explicitly uses "and" between two distinct actions
  (incremental backup and restore; backup and restore functions;
  merge and import) were reworded with と/および instead of silently
  joining into one compound, to preserve the "and" meaning.
@ti-chi-bot

ti-chi-bot Bot commented Sep 2, 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 Sep 2, 2026
@coderabbitai

coderabbitai Bot commented Sep 2, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The pull request updates Japanese documentation terminology, punctuation, translations, and contributor attributions across general guides, BR and DR pages, release notes, and TiDB Cloud documentation. It introduces no functional or technical changes.

Changes

Documentation terminology updates

Layer / File(s) Summary
General terminology standardization
ai/examples/image-search-with-pytidb.md, develop/..., explore-htap.md, faq/..., glossary.md, import-example-data.md, migrate-from-tidb-to-tidb.md, migration-overview.md, optimizer-hints.md, privilege-management.md, sql-plan-management.md, tidb-resource-control-*.md, troubleshoot-lock-conflicts.md
Japanese terms, punctuation, optimizer hint descriptions, link text, and migration wording were standardized without changing technical content.
BR and disaster recovery terminology
br/*.md, dr-secondary-cluster.md
Checkpoint backup, checkpoint restore, and primary-secondary terminology were standardized.
Release note wording and attributions
releases/*.md
Release note punctuation, checkpoint restore terminology, cluster terminology, and contributor names were updated.
TiDB Cloud terminology
tidb-cloud/**/*.md
DBaaS, HTAP, certificate authority, FAQ, and benchmark executor terminology were standardized. Existing anchors, links, and technical content remain unchanged.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: 🔵 Low · up to 5f116

The PR standardizes Japanese technical-term spelling across 40 documentation files, but a few release-note edits still omit contributor @ markers and contain one duplicated character. The changes are mergeable with explicit owner follow-up to correct these localized text issues.

Suggested reviewers: invalid-email-address, qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: removing unnecessary middle dots from Japanese Katakana compound terms.
Description check ✅ Passed The description explains the scope, rationale, examples, exclusions, affected documentation version, and AI involvement. The related-link fields are blank, but they are not essential because the chang…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
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.
Full details: Description check

Explanation

The description explains the scope, rationale, examples, exclusions, affected documentation version, and AI involvement. The related-link fields are blank, but they are not essential because the changes and scope are documented clearly.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (40 skipped: 40 unsupported.)

✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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 commented Sep 2, 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 breezewish 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 area/develop This PR relates to the area of TiDB App development. 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 Sep 2, 2026
…n-vs-feature wording, and Capital Bikeshare license link text
…ege-management.md

Nearly every heading in the privilege-related-operations section of
privilege-management.md had translated the literal SQL command name
(matching a section heading per statement, e.g. ALTER, BACKUP, CREATE
DATABASE, GRANT, REVOKE, CREATE/ALTER/DROP RESOURCE GROUP) into
descriptive Japanese, instead of keeping it as literal English like
the rest of the corpus consistently does (confirmed via TOC.md and
sql-statements/sql-statement-overview.md, which both correctly keep
these as literal backtick-quoted English). 31 headings restored.

Also fixed the matching CREATE/DROP RESOURCE GROUP entries in
tidb-resource-control-ru-groups.md's See also list, which had the
same descriptive-Japanese mistranslation for 2 of its 3 sibling
entries.
… privilege-management.md

Multiple defects found via user's line-by-line review of the
privilege-related-operations section:
- Broken verb ending (X権限ている -> X権限を持っている) in the ALTER bullet list
- RENAME TABLE description ended as an incomplete sentence fragment
  with no verb, and used incorrect する後 instead of した後
- SHOW CREATE TABLE / SHOW GRANTS / User+Host sentences missing a
  subject-marking は particle, causing misreadable run-ons
- SHOW GRANTS description had SELECT and mysql swapped (said "mysql
  privilege to the SELECT database" instead of "SELECT privilege to
  the mysql database")
- Same swap defect in the user-table paragraph (DELETE/user reversed)
  and in the tables_priv/columns_priv paragraph (% and tables_priv
  reversed)
- ALTER USER dropped the の particle, inconsistent with every sibling
  entry's "Xの権限が必要です" pattern
- GRANT section had a garbled single-noun-phrase structure instead of
  mirroring the correctly-structured REVOKE section right below it
  (both should say "X権限と、Yの権限が必要です")
- SET RESOURCE GROUP: missing が particle before 「ONに設定されている場合」
- Time of effect section: missing などの before both statement-list
  summaries, making 4 example statements read as if they were
  collectively named "privilege management statement(s)" rather than
  examples of that category
…order in privilege-management.md"

This reverts commit 1b40baf.
…n privilege-management.md"

This reverts commit a09ebe1.
@yahonda
yahonda marked this pull request as ready for review September 2, 2026 02:30
@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 Sep 2, 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: 2


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: f2818fb0-d1bf-4cd9-b590-b83733850dff

📥 Commits

Reviewing files that changed from the base of the PR and between adfeb1f and 5f116a6.

📒 Files selected for processing (40)
  • ai/examples/image-search-with-pytidb.md
  • br/br-checkpoint-backup.md
  • br/br-checkpoint-restore.md
  • develop/dev-guide-connection-parameters.md
  • develop/dev-guide-create-table.md
  • develop/dev-guide-hybrid-oltp-and-olap-queries.md
  • dr-secondary-cluster.md
  • explore-htap.md
  • faq/deploy-and-maintain-faq.md
  • glossary.md
  • import-example-data.md
  • migrate-from-tidb-to-tidb.md
  • migration-overview.md
  • optimizer-hints.md
  • privilege-management.md
  • releases/release-6.1.0.md
  • releases/release-6.5.6.md
  • releases/release-7.1.0.md
  • releases/release-7.1.3.md
  • sql-plan-management.md
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/dedicated/_index.md
  • tidb-cloud/essential/_index.md
  • tidb-cloud/premium/_index.md
  • tidb-cloud/secure-connections-to-serverless-clusters.md
  • tidb-cloud/starter/_index.md
  • tidb-cloud/tidb-cloud-faq.md
  • tidb-cloud/v6.5-performance-benchmarking-with-sysbench.md
  • tidb-cloud/v6.5-performance-benchmarking-with-tpcc.md
  • tidb-cloud/v7.1-performance-benchmarking-with-sysbench.md
  • tidb-cloud/v7.1-performance-benchmarking-with-tpcc.md
  • tidb-cloud/v7.5-performance-benchmarking-with-sysbench.md
  • tidb-cloud/v7.5-performance-benchmarking-with-tpcc.md
  • tidb-cloud/v8.1-performance-benchmarking-with-sysbench.md
  • tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md
  • tidb-cloud/v8.5-performance-benchmarking-with-sysbench.md
  • tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md
  • tidb-resource-control-ru-groups.md
  • tidb-resource-control-runaway-queries.md
  • troubleshoot-lock-conflicts.md

Included review availability: Your plan provides up to 4 included reviews per hour; 0 remain after this review.

Comment thread releases/release-6.5.6.md
- [`compression`](/ticdc/ticdc-changefeed-config.md) : REDOログファイルの圧縮動作を設定できます[#10176](https://github.com/pingcap/tiflow/issues/10176) @[sdojjy](https://github.com/sdojjy)
- [`changefeed-error-stuck-duration`](/ticdc/ticdc-changefeed-config.md) : 内部エラーまたは例外が発生したときに、変更フィードが自動的に再試行される期間を設定できます[#9875](https://github.com/pingcap/tiflow/issues/9875) @[asddongmen](https://github.com/asddongmen)
- [`sink.cloud-storage-config`](/ticdc/ticdc-changefeed-config.md) : オブジェクトストレージにデータを複製するときに履歴データの自動クリーンアップを設定できます[チャールズ・チュン96](https://github.com/CharlesCheung96) [#10109](https://github.com/pingcap/tiflow/issues/10109)
- [`sink.cloud-storage-config`](/ticdc/ticdc-changefeed-config.md) : オブジェクトストレージにデータを複製するときに履歴データの自動クリーンアップを設定できます[CharlesCheung96](https://github.com/CharlesCheung96) [#10109](https://github.com/pingcap/tiflow/issues/10109)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Preserve the @ marker in contributor attributions.

The changed contributor links omit the marker used by the surrounding release notes.

  • releases/release-6.5.6.md#L24-L24: Add @ before CharlesCheung96.
  • releases/release-6.5.6.md#L36-L36: Add @ before tonyxuqqi.
  • releases/release-7.1.3.md#L21-L21: Add @ before CharlesCheung96.
📍 Affects 2 files
  • releases/release-6.5.6.md#L24-L24 (this comment)
  • releases/release-6.5.6.md#L36-L36
  • releases/release-7.1.3.md#L21-L21

Comment thread releases/release-7.1.0.md
スナップショットの復元やログの復元は、ディスク枯渇やノードクラッシュなどの回復可能なエラーにより中断される可能性があります。TiDB v7.1.0より前のバージョンでは、エラーに対処した後でも中断前の復元の進行状況が無効になり、復元を最初からやり直す必要がありました。大規模クラスターでは、これはかなりの追加コストが発生します。

TiDB v7.1.0以降、バックアップ&リストア(BR)にチェックポイント・リストア機能が導入され、中断されたリストアを再開できるようになりました。この機能により、中断されたリストアのリカバリ進行状況の大部分を保持できます。
TiDB v7.1.0以降、バックアップ&リストア(BR)にチェックポイントリストア機能が導入され、中断されたリストアを再開できるようになりました。この機能により、中断されたリストアのリカバリ進行状況の大部分を保持できます。

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Remove the duplicated 「再」.

再再開 is a typo. Use 再開 for the restore operation.

As per path instructions: “For every actionable issue, provide a GitHub committable suggestion block containing the exact replacement text whenever the fix can be safely and completely applied to contiguous lines in the diff.”

Committable suggestion
Suggested change
TiDB v7.1.0以降、バックアップ&リストア(BR)にチェックポイントリストア機能が導入され、中断されたリストアを再開できるようになりました。この機能により、中断されたリストアのリカバリ進行状況の大部分を保持できます。
TiDB v7.1.0以降、バックアップ&リストア(BR)にチェックポイントリストア機能が導入され、中断されたリストアを再開できるようになりました。この機能により、中断されたリストアのリカバリ進行状況の大部分を保持できます。

Source: Path instructions

@qiancai qiancai added translation/no-need No need to translate this PR. and removed missing-translation-status This PR does not have translation status info. labels Sep 2, 2026
@ti-chi-bot ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Sep 2, 2026
@ti-chi-bot

ti-chi-bot Bot commented Sep 2, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-09-02 03:49:46.760335588 +0000 UTC m=+1251221.931429702: ☑️ agreed by qiancai.

@qiancai
qiancai merged commit 23d5ab9 into pingcap:i18n-ja-release-8.5 Sep 2, 2026
2 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/develop This PR relates to the area of TiDB App development. needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/L Denotes a PR that changes 100-499 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