Skip to content

i18n(ja): fix dropped topic-marker particle before predicates - #23626

Open
yahonda wants to merge 4 commits into
i18n-ja-release-8.5from
fix-dropped-ha-particles-draft-2026-08-27
Open

i18n(ja): fix dropped topic-marker particle before predicates#23626
yahonda wants to merge 4 commits into
i18n-ja-release-8.5from
fix-dropped-ha-particles-draft-2026-08-27

Conversation

@yahonda

@yahonda yahonda commented Aug 27, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Continuation of the dropped-particle review (を: #23579/#23611, が: #23624) for は (topic particle) — dropped immediately after a code span/bracket, before a definitional or state predicate (becomes/is called/represents/corresponds to/is supported/etc.).

Started at 55 sites/51 files from a code-span/bracket-adjacent regex scan. Through iterative human review, two systemic false-positive classes were found and fully reverted:

  1. になります/となります predicates (18 sites): the captured code span/bracket is the COMPLEMENT of the "becomes X" predicate, not its subject — e.g. "この機能が一般提供(GA)となります" was wrongly edited to "一般提供(GA)はとなります" (GA is what the feature becomes, not a new topic).
  2. と呼ばれる/と呼ばれます, を表す/を表します/を意味します/を指す, に相当します/に相当する predicates (24 sites): same complement-vs-subject issue for "is called X" patterns, plus predicates already starting with a particle (を.../に...) mean the code span is already correctly particle-marked as that verb's argument — inserting は immediately before an existing を/に produces stacked-particle nonsense (「Xはを指す」).

Also reverted 2 sites that sit inside a pre-existing, unrelated MT-scramble defect where a particle insertion alone can't produce a grammatical sentence (already independently flagged/skipped for the same reason during the が sweep, #23624), and one site (performance-tuning-overview.md) superseded by a fuller rewrite in #23627.

CodeRabbit caught 3 more sites where a partial fix wasn't enough — hybrid-deployment-topology.md and ticdc/ticdc-compatibility.md needed a fuller rewrite beyond just the added particle, both applied and verified against the English source.

Reviewed and confirmed clean by the PR author. 11 sites across 11 files remain, from predicate categories that held up under review (有効です/可能です/サポートされていません/必要です/デフォルトで/利用できません/含まれます — state predicates where the code span genuinely is what's being described).

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)?

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
    • Corrected Japanese grammar, terminology, and phrasing across cloud, deployment, SQL, TiCDC, release notes, and _tidb_rowid documentation.
    • Clarified session termination guidance for older or non-global-kill configurations, including the requirement to connect directly to the relevant TiDB instance.
    • Improved the clarity of backup, compatibility, encryption, optimizer, and deployment guidance without changing technical behavior.

@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 27, 2026
@ti-chi-bot

ti-chi-bot Bot commented Aug 27, 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

@coderabbitai

coderabbitai Bot commented Aug 27, 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

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 90becb07-5e1b-4f27-be80-b94395638110

📥 Commits

Reviewing files that changed from the base of the PR and between f99af01 and bc35194.

📒 Files selected for processing (1)
  • ticdc/ticdc-compatibility.md

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


📝 Walkthrough

Walkthrough

The PR corrects Japanese grammar and phrasing in ten documentation pages. It also clarifies direct-connection requirements for session termination commands in the cluster FAQ. No functional or public entity changes are included.

Changes

Documentation updates

Layer / File(s) Summary
Session termination guidance
faq/manage-cluster-faq.md
The FAQ clarifies when kill session_id is unavailable and requires a direct connection to the TiDB instance running the DML before using kill tidb session_id.
Japanese wording corrections
best-practices/best-practices-on-public-cloud.md, hybrid-deployment-topology.md, releases/*, sql-statements/*, ticdc/ticdc-compatibility.md, tidb-cloud/tidb-cloud-encrypt-cmek-aws.md, tidb-rowid.md
The documentation adds missing Japanese particles and corrects phrasing in public cloud, deployment, release, SQL, TiCDC, TiDB Cloud, and _tidb_rowid content.

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

Merge Risk: ⚪ Minimal · up to bc351

This PR makes localized Japanese documentation wording corrections without introducing actionable merge-blocking risk; it is merge-ready after normal checks and review.

Suggested reviewers: qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
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.
Title check ✅ Passed The title clearly and concisely describes the main change: fixing omitted Japanese は topic-marker particles.
Description check ✅ Passed The description explains the changes, review scope, false-positive handling, affected documentation version, related PRs, AI involvement, and change categories. The version checkbox differs from the t…
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. (1 skipped: 1 unsupported.)

Full details: Description check

Explanation

The description explains the changes, review scope, false-positive handling, affected documentation version, related PRs, AI involvement, and change categories. The version checkbox differs from the template options, but the intended TiDB 8.5 Japanese documentation scope is clearly stated.

✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix-dropped-ha-particles-draft-2026-08-27

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 area/develop This PR relates to the area of TiDB App development. missing-translation-status This PR does not have translation status info. labels Aug 27, 2026
@ti-chi-bot

ti-chi-bot Bot commented Aug 27, 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 27, 2026
@yahonda
yahonda force-pushed the fix-dropped-ha-particles-draft-2026-08-27 branch from 1a2da03 to b2fae22 Compare August 27, 2026 02:27
@ti-chi-bot ti-chi-bot Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 27, 2026
Started at 55 sites/51 files. Two systemic false-positive classes were
found and fully reverted through iterative user review:

1. になります/となります predicates (18 sites): the captured code
   span/bracket is the COMPLEMENT of the "becomes X" predicate, not
   its subject -- e.g. "この機能が一般提供(GA)となります" was
   mis-edited to "一般提供(GA)はとなります", which is ungrammatical
   since GA is what the feature becomes, not a new topic.

2. と呼ばれる/と呼ばれます, を表す/を表します/を意味します/を指す,
   に相当します/に相当する predicates (24 sites): same complement-vs-
   subject issue for "is called X" patterns, plus a related structural
   flaw -- predicates already starting with a particle (を.../に...)
   mean the code span is already correctly particle-marked as that
   verb's argument, so inserting は immediately before an existing
   を/に is always wrong (produces stacked-particle nonsense like
   「Xはを指す」).

Also reverted 2 sites (dm/dm-error-handling.md, tidb-cloud/sql-
concepts.md) that turned out to sit inside a pre-existing, unrelated
MT-scramble defect where a particle insertion alone cannot produce a
grammatical sentence -- these had already been independently flagged
and skipped for the same reason during the earlier が sweep (#23624).

11 sites across 11 files remain, from predicate categories that held
up under review (有効です/可能です/サポートされていません/必要です/
デフォルトで/利用できません/含まれます) -- these are still NOT
individually re-verified against the English source, so continue to
treat this as a draft.
@yahonda
yahonda force-pushed the fix-dropped-ha-particles-draft-2026-08-27 branch from b2fae22 to e2078b2 Compare August 27, 2026 02:38
@ti-chi-bot ti-chi-bot Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 27, 2026
Per user review: for "you need to [do A] and [do B]" (two verb-ending
action phrases), は必要です (a bare-noun-topic construction) reads
awkwardly. Reworded to 必要があります (attaches directly to a verb)
and changed the conjunction from と to a comma with the first link's
displayed text switched to conjunctive (masu-stem) form, matching how
Japanese naturally lists two sequential actions before a shared verb.
@yahonda yahonda changed the title i18n(ja): fix dropped は particle before predicates (draft, needs review) i18n(ja): fix dropped は particle before predicates Aug 27, 2026
@yahonda
yahonda marked this pull request as ready for review August 27, 2026 02:44
@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 27, 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: 4378c41b-9f97-4364-8119-fbb62307c557

📥 Commits

Reviewing files that changed from the base of the PR and between d41688a and 5c36c9d.

📒 Files selected for processing (11)
  • best-practices/best-practices-on-public-cloud.md
  • faq/manage-cluster-faq.md
  • hybrid-deployment-topology.md
  • performance-tuning-overview.md
  • releases/release-6.5.0.md
  • releases/release-8.2.0.md
  • sql-statements/sql-statement-backup.md
  • sql-statements/sql-statement-set-transaction.md
  • ticdc/ticdc-compatibility.md
  • tidb-cloud/tidb-cloud-encrypt-cmek-aws.md
  • tidb-rowid.md

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

Comment thread hybrid-deployment-topology.md Outdated
Comment thread performance-tuning-overview.md Outdated
Comment thread ticdc/ticdc-compatibility.md Outdated
@yahonda yahonda changed the title i18n(ja): fix dropped は particle before predicates i18n(ja): fix dropped topic-marker particle before predicates Aug 27, 2026
- hybrid-deployment-topology.md: CodeRabbit correctly flagged that the
  added は alone didn't fix the remaining broken grammar around
  deploy_dir/なります; applied a fuller rewrite, verified against EN.
- ticdc/ticdc-compatibility.md: fixed the が-drop CodeRabbit found
  (`data-dir`が正しく構成されている), plus a second を-drop noticed
  in the same table cell while there (`data-dir`を`cdc server`...).
- performance-tuning-overview.md: reverted this PR's は-only patch --
  the whole scrambled sentence containing it is already fixed more
  completely in #23627, so this PR no longer needs to touch the file.

@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

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f98061bd-0f98-4619-af48-5ede7899bab1

📥 Commits

Reviewing files that changed from the base of the PR and between 5c36c9d and f99af01.

📒 Files selected for processing (2)
  • hybrid-deployment-topology.md
  • ticdc/ticdc-compatibility.md

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

Comment thread ticdc/ticdc-compatibility.md Outdated
…c-compatibility.md

- Per CodeRabbit: added の to bind "v4.0.14以降" to "v4.0バージョン"
  (and same for v5.0.3/v5.0), matching EN's "v4.0.14 and later v4.0
  versions" -- the bare commas could misread as separate conditions.
- Found the same が-drop and を-drop pattern (already fixed on the
  v4.0.14+ row) also present on the sibling v4.0.12-v5.0.1 row just
  above it in the same table.
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. missing-translation-status This PR does not have translation status info. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant