Skip to content

i18n(ja): add missing long vowel mark to katakana operator term - #23594

Open
yahonda wants to merge 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-operator-chouon-unification
Open

i18n(ja): add missing long vowel mark to katakana operator term#23594
yahonda wants to merge 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-operator-chouon-unification

Conversation

@yahonda

@yahonda yahonda commented Aug 25, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Unifies the katakana rendering of "operator" in two ways, per this corpus's own glossary.md#operator entry and a prior term decision.

This corpus uses "operator" in several distinct senses:

  • SQL/expression operator (comparison, logical, arithmetic, etc.) — unaffected, stays 演算子.
  • PD scheduling operator (region balance/leader-schedule operators, etc.) and execution-plan operator (TableScan/HashAgg/Exchange/TopN/Join/etc.) — both use the katakana term; this PR:
    1. Normalizes long-vowel spelling: 155 occurrences across 53 files from オペレータ to オペレーター, matching the glossary's own spelling.
    2. Disambiguates 演算子 (the SQL-operator term) from オペレーター (the plan/scheduling-operator term) wherever 演算子 was actually used for an execution-plan or generic plan-context reference (e.g. TableScanオペレーター, 各オペレーター, 結合オペレーター, 物理オペレーター) — 205 occurrences across 81 files. Left untouched: 比較/論理/算術/ビット/代入/集合演算子 and everything under functions-and-operators/, which correctly refer to SQL-level operators.
  • Specific named PD operator kinds mentioned in release-note prose (e.g. "transfer leader operator", "Merge Region operator") were previously translated into Japanese; restored to their literal English names, since they name a specific operator kind rather than using "operator" generically.
  • Grafana PD dashboard panel names (the 8 metrics under the "Operator" section of grafana-pd-dashboard.md) were previously translated; restored to their literal English titles to match what Grafana actually displays.
  • TiDB/Kubernetes Operator (proper noun) — never rendered in katakana in this corpus (always kept as literal English "TiDB Operator"), so no conflict with any of the above.

This pass is not exhaustive — some bare, unprefixed 演算子 mentions in plan-context prose (e.g. "異なる演算子") were not caught by the pattern-based sweep and may need a follow-up pass.

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 for “operator” across guides, dashboards, troubleshooting content, SQL documentation, and release notes.
    • Corrected minor wording, grammar, formatting, and typographical inconsistencies.
    • Clarified selected troubleshooting, optimization, scheduling, and release-note descriptions, including version references and supported operators.
    • Added details for certain documented fixes and metrics without changing their meaning.
    • No functional, configuration, or behavioral changes.

@ti-chi-bot ti-chi-bot Bot added the missing-translation-status This PR does not have translation status info. label Aug 25, 2026
@ti-chi-bot

ti-chi-bot Bot commented Aug 25, 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 the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Aug 25, 2026
@coderabbitai

coderabbitai Bot commented Aug 25, 2026

Copy link
Copy Markdown

Review 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

Walkthrough

This documentation-only change standardizes Japanese operator terminology across operational guides, SQL references, configuration documentation, dashboards, FAQs, TiFlash documentation, and historical release notes. It also corrects several Japanese wording and formatting issues.

Changes

Japanese terminology standardization

Layer / File(s) Summary
Documentation terminology updates
alert-rules.md, best-practices/*, dashboard/*, releases/*, sql-statements/*, tiflash/*, and related documentation
Japanese operator terminology is standardized across scheduling, SQL, configuration, dashboard, FAQ, TiFlash, and release-note content. Several wording corrections, metadata updates, and release-note clarifications are included. Technical behavior remains unchanged.

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

Merge Risk: 🟡 Moderate · up to a4c5c

This documentation-only PR standardizes Japanese operator terminology across many files, but the current head still contains factual and usability errors, inconsistent terminology, and Markdown formatting violations that can mislead readers or fail documentation checks. Merge should wait for these bounded corrections or explicit owner acceptance.

Suggested reviewers: qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: normalizing the Japanese katakana spelling of “operator” by adding the long-vowel mark.
Description check ✅ Passed The description is complete and directly explains the terminology changes, affected scope, version target, AI involvement, and known limitations. The related-link fields are blank, but they are non-cr…
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 is complete and directly explains the terminology changes, affected scope, version target, AI involvement, and known limitations. The related-link fields are blank, but they are non-critical for this documentation-only change.

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. (149 skipped: 149 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.

@yahonda
yahonda force-pushed the fix-operator-chouon-unification branch from c0c1387 to 475673e Compare August 25, 2026 01:06
@yahonda yahonda changed the title i18n(ja): normalize オペレータ to オペレーター (long vowel mark) i18n(ja): add missing long vowel mark to katakana operator term Aug 25, 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

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 2f6aff41-8971-4825-8463-f479951a3f9d

📥 Commits

Reviewing files that changed from the base of the PR and between 603a4d9 and c0c1387.

📒 Files selected for processing (53)
  • alert-rules.md
  • best-practices/pd-scheduling-best-practices.md
  • best-practices/three-nodes-hybrid-deployment.md
  • choose-index.md
  • configure-store-limit.md
  • dashboard/dashboard-slow-query.md
  • dashboard/dashboard-statement-details.md
  • dynamic-config.md
  • explain-overview.md
  • faq/manage-cluster-faq.md
  • grafana-pd-dashboard.md
  • grafana-tidb-dashboard.md
  • pd-control.md
  • performance-tuning-methods.md
  • releases/release-2.0.2.md
  • releases/release-2.1-rc.2.md
  • releases/release-2.1.17.md
  • releases/release-2.1.8.md
  • releases/release-3.0-ga.md
  • releases/release-3.0.0-rc.1.md
  • releases/release-3.0.0-rc.3.md
  • releases/release-4.0.0-beta.1.md
  • releases/release-4.0.0-beta.md
  • releases/release-4.0.2.md
  • releases/release-4.0.7.md
  • releases/release-4.0.8.md
  • releases/release-5.0.0-rc.md
  • releases/release-5.0.3.md
  • releases/release-5.1.4.md
  • releases/release-5.3.0.md
  • releases/release-5.4.1.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.3.0.md
  • releases/release-6.5.11.md
  • releases/release-6.6.0.md
  • releases/release-7.0.0.md
  • releases/release-7.1.6.md
  • releases/release-7.5.2.md
  • releases/release-7.5.3.md
  • releases/release-7.5.7.md
  • releases/release-8.0.0.md
  • releases/release-8.1.1.md
  • releases/release-rc.2.md
  • runtime-filter.md
  • sql-statements/sql-statement-explain-analyze.md
  • sql-statements/sql-statement-explain.md
  • sql-tuning-best-practice.md
  • system-variables.md
  • tidb-cloud/tidb-cloud-console-auditing.md
  • tidb-scheduling.md
  • tiflash/tiflash-spill-disk.md
  • tiflash/troubleshoot-tiflash.md

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

Comment thread best-practices/three-nodes-hybrid-deployment.md
Comment thread performance-tuning-methods.md Outdated
Comment thread releases/release-2.0.2.md Outdated
@ti-chi-bot ti-chi-bot Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 25, 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: 16


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: b4961bac-0753-4279-b056-f01a91a1e162

📥 Commits

Reviewing files that changed from the base of the PR and between c0c1387 and 802521b.

📒 Files selected for processing (81)
  • analyze-slow-queries.md
  • blocklist-control-plan.md
  • choose-index.md
  • configure-memory-usage.md
  • cost-model.md
  • dashboard/dashboard-slow-query.md
  • dashboard/dashboard-statement-details.md
  • derive-topn-from-window.md
  • explain-joins.md
  • explain-mpp.md
  • explain-overview.md
  • explain-subqueries.md
  • explain-walkthrough.md
  • glossary.md
  • grafana-pd-dashboard.md
  • information-schema/information-schema-slow-query.md
  • max-min-eliminate.md
  • optimizer-hints.md
  • predicate-push-down.md
  • releases/release-1.1-alpha.md
  • releases/release-2.0-ga.md
  • releases/release-2.0-rc.1.md
  • releases/release-2.0.2.md
  • releases/release-2.1-ga.md
  • releases/release-2.1-rc.4.md
  • releases/release-2.1.18.md
  • releases/release-3.0.0-rc.1.md
  • releases/release-3.0.4.md
  • releases/release-3.0.5.md
  • releases/release-4.0.2.md
  • releases/release-4.0.5.md
  • releases/release-5.0.0-rc.md
  • releases/release-5.0.0.md
  • releases/release-5.0.3.md
  • releases/release-5.2.0.md
  • releases/release-5.2.4.md
  • releases/release-6.1.0.md
  • releases/release-6.1.6.md
  • releases/release-6.5.1.md
  • releases/release-6.5.10.md
  • releases/release-6.5.2.md
  • releases/release-6.5.3.md
  • releases/release-6.5.4.md
  • releases/release-6.5.6.md
  • releases/release-6.5.7.md
  • releases/release-6.5.8.md
  • releases/release-7.0.0.md
  • releases/release-7.1.0.md
  • releases/release-7.1.2.md
  • releases/release-7.1.3.md
  • releases/release-7.1.4.md
  • releases/release-7.1.6.md
  • releases/release-7.3.0.md
  • releases/release-7.4.0.md
  • releases/release-7.5.1.md
  • releases/release-7.5.2.md
  • releases/release-7.6.0.md
  • releases/release-8.0.0.md
  • releases/release-8.1.0.md
  • releases/release-8.1.1.md
  • releases/release-8.2.0.md
  • releases/release-8.3.0.md
  • releases/release-8.4.0.md
  • releases/release-8.5.3.md
  • releases/release-8.5.6.md
  • releases/release-rc.4.md
  • runtime-filter.md
  • sql-logical-optimization.md
  • sql-physical-optimization.md
  • sql-statements/sql-statement-explain-analyze.md
  • sql-statements/sql-statement-explain.md
  • sql-tuning-best-practice.md
  • system-variables.md
  • tiflash-performance-tuning-methods.md
  • tiflash/tiflash-configuration.md
  • tiflash/tiflash-late-materialization.md
  • tiflash/tiflash-spill-disk.md
  • tiflash/tiflash-supported-pushdown-calculations.md
  • tiflash/use-tiflash-mpp-mode.md
  • topn-limit-push-down.md
  • troubleshoot-tidb-oom.md

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

Comment thread choose-index.md Outdated
Comment thread derive-topn-from-window.md
Comment thread explain-joins.md Outdated
Comment thread explain-subqueries.md Outdated
Comment thread grafana-pd-dashboard.md Outdated
Comment thread releases/release-4.0.5.md Outdated
Comment thread releases/release-5.0.0.md Outdated
Comment thread releases/release-7.4.0.md Outdated
Comment thread releases/release-7.5.2.md Outdated
Comment thread sql-statements/sql-statement-explain-analyze.md Outdated
@ti-chi-bot ti-chi-bot Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. area/develop This PR relates to the area of TiDB App development. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Aug 25, 2026
@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 Aug 25, 2026
@yahonda
yahonda force-pushed the fix-operator-chouon-unification branch from b4a0ff8 to a4c5c78 Compare August 25, 2026 08:12
@coderabbitai

coderabbitai Bot commented Aug 25, 2026

Copy link
Copy Markdown

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.

@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: 20


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 19497abd-f022-468d-9b81-d64bc65287ed

📥 Commits

Reviewing files that changed from the base of the PR and between 783a9f7 and a4c5c78.

📒 Files selected for processing (149)
  • alert-rules.md
  • analyze-slow-queries.md
  • best-practices/pd-scheduling-best-practices.md
  • best-practices/three-nodes-hybrid-deployment.md
  • blocklist-control-plan.md
  • cached-tables.md
  • choose-index.md
  • configure-memory-usage.md
  • configure-store-limit.md
  • cost-model.md
  • dashboard/dashboard-slow-query.md
  • dashboard/dashboard-statement-details.md
  • derive-topn-from-window.md
  • develop/dev-guide-optimize-sql.md
  • dynamic-config.md
  • explain-aggregation.md
  • explain-index-merge.md
  • explain-indexes.md
  • explain-joins.md
  • explain-mpp.md
  • explain-overview.md
  • explain-partitions.md
  • explain-subqueries.md
  • explain-walkthrough.md
  • explore-htap.md
  • faq/manage-cluster-faq.md
  • functions-and-operators/group-by-modifier.md
  • glossary.md
  • grafana-pd-dashboard.md
  • grafana-tidb-dashboard.md
  • information-schema/information-schema-slow-query.md
  • max-min-eliminate.md
  • optimizer-fix-controls.md
  • optimizer-hints.md
  • pd-control.md
  • performance-tuning-methods.md
  • predicate-push-down.md
  • quick-start-with-htap.md
  • releases/release-1.1-alpha.md
  • releases/release-2.0-ga.md
  • releases/release-2.0-rc.1.md
  • releases/release-2.0-rc.3.md
  • releases/release-2.0.2.md
  • releases/release-2.1-ga.md
  • releases/release-2.1-rc.1.md
  • releases/release-2.1-rc.2.md
  • releases/release-2.1-rc.3.md
  • releases/release-2.1-rc.4.md
  • releases/release-2.1.17.md
  • releases/release-2.1.18.md
  • releases/release-2.1.5.md
  • releases/release-2.1.8.md
  • releases/release-3.0-ga.md
  • releases/release-3.0.0-rc.1.md
  • releases/release-3.0.0-rc.3.md
  • releases/release-3.0.4.md
  • releases/release-3.0.5.md
  • releases/release-4.0.0-beta.1.md
  • releases/release-4.0.0-beta.md
  • releases/release-4.0.0-rc.2.md
  • releases/release-4.0.11.md
  • releases/release-4.0.13.md
  • releases/release-4.0.15.md
  • releases/release-4.0.2.md
  • releases/release-4.0.4.md
  • releases/release-4.0.5.md
  • releases/release-4.0.6.md
  • releases/release-4.0.7.md
  • releases/release-4.0.8.md
  • releases/release-5.0.0-rc.md
  • releases/release-5.0.0.md
  • releases/release-5.0.1.md
  • releases/release-5.0.3.md
  • releases/release-5.1.0.md
  • releases/release-5.1.4.md
  • releases/release-5.1.5.md
  • releases/release-5.2.0.md
  • releases/release-5.2.1.md
  • releases/release-5.2.4.md
  • releases/release-5.3.0.md
  • releases/release-5.3.2.md
  • releases/release-5.4.0.md
  • releases/release-5.4.1.md
  • releases/release-5.4.3.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.6.md
  • releases/release-6.3.0.md
  • releases/release-6.5.0.md
  • releases/release-6.5.1.md
  • releases/release-6.5.10.md
  • releases/release-6.5.11.md
  • releases/release-6.5.12.md
  • releases/release-6.5.2.md
  • releases/release-6.5.3.md
  • releases/release-6.5.4.md
  • releases/release-6.5.6.md
  • releases/release-6.5.7.md
  • releases/release-6.5.8.md
  • releases/release-6.5.9.md
  • releases/release-6.6.0.md
  • releases/release-7.0.0.md
  • releases/release-7.1.0.md
  • releases/release-7.1.2.md
  • releases/release-7.1.3.md
  • releases/release-7.1.4.md
  • releases/release-7.1.6.md
  • releases/release-7.3.0.md
  • releases/release-7.4.0.md
  • releases/release-7.5.1.md
  • releases/release-7.5.2.md
  • releases/release-7.5.3.md
  • releases/release-7.5.4.md
  • releases/release-7.5.7.md
  • releases/release-7.6.0.md
  • releases/release-8.0.0.md
  • releases/release-8.1.0.md
  • releases/release-8.1.1.md
  • releases/release-8.2.0.md
  • releases/release-8.3.0.md
  • releases/release-8.4.0.md
  • releases/release-8.5.0.md
  • releases/release-8.5.3.md
  • releases/release-8.5.4.md
  • releases/release-8.5.5.md
  • releases/release-8.5.6.md
  • releases/release-rc.2.md
  • releases/release-rc.4.md
  • runtime-filter.md
  • sql-logical-optimization.md
  • sql-physical-optimization.md
  • sql-prepared-plan-cache.md
  • sql-statements/sql-statement-explain-analyze.md
  • sql-statements/sql-statement-explain.md
  • sql-tuning-best-practice.md
  • system-variables.md
  • tidb-cloud/tidb-cloud-console-auditing.md
  • tidb-performance-tuning-config.md
  • tidb-scheduling.md
  • tiflash-performance-tuning-methods.md
  • tiflash/tiflash-configuration.md
  • tiflash/tiflash-late-materialization.md
  • tiflash/tiflash-pipeline-model.md
  • tiflash/tiflash-spill-disk.md
  • tiflash/tiflash-supported-pushdown-calculations.md
  • tiflash/troubleshoot-tiflash.md
  • tiflash/use-tiflash-mpp-mode.md
  • topn-limit-push-down.md
  • troubleshoot-tidb-oom.md

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

Comment thread analyze-slow-queries.md Outdated
Comment thread cached-tables.md
Comment thread dashboard/dashboard-slow-query.md Outdated
Comment thread explain-aggregation.md Outdated
Comment thread explain-mpp.md Outdated
Comment thread tiflash/tiflash-spill-disk.md Outdated
Comment thread tiflash/tiflash-spill-disk.md Outdated
Comment thread tiflash/tiflash-supported-pushdown-calculations.md Outdated
Comment thread tiflash/tiflash-supported-pushdown-calculations.md Outdated
Comment thread tiflash/troubleshoot-tiflash.md Outdated
@yahonda
yahonda marked this pull request as draft August 25, 2026 08:45
@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 Aug 25, 2026
@yahonda
yahonda force-pushed the fix-operator-chouon-unification branch from a4c5c78 to b92b8ef Compare August 26, 2026 00:51
@yahonda
yahonda marked this pull request as ready for review August 26, 2026 01:05
@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 Aug 26, 2026
Unifies the katakana rendering of "operator" per this corpus's own
glossary.md#operator entry: normalizes long-vowel spelling (オペレータ
-> オペレーター) and disambiguates 演算子 (SQL-level operator) from
オペレーター (execution-plan/PD-scheduling operator) wherever 演算子
was actually used for a plan-context reference. SQL/expression
operators (比較/論理/算術/etc. 演算子) are left untouched.

Also completes the unification for execution-plan and PD scheduling
operators left inconsistent after the initial pass, plus stray
emphasis markers, missing particles, and garbled sentences found by
review, each verified against the current file content and the
English source.
@yahonda
yahonda force-pushed the fix-operator-chouon-unification branch from b90731d to f66b1ba Compare August 27, 2026 04:30
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. 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