Skip to content

i18n(ja): fix dropped subject-marker particle before predicates - #23624

Open
yahonda wants to merge 7 commits into
i18n-ja-release-8.5from
fix-dropped-ga-particles-2026-08-27
Open

i18n(ja): fix dropped subject-marker particle before predicates#23624
yahonda wants to merge 7 commits into
i18n-ja-release-8.5from
fix-dropped-ga-particles-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 comprehensive dropped-particle review (following #23579 and #23611, which covered を drops before common action verbs). This PR covers the が particle — dropped immediately after a code span/bracket, before a state-describing or passive predicate (e.g. 有効です, 必要です, 設定されます, 削除されます, 無視されます).

Example: EN "If set, --from and --to will be ignored." was translated as "設定されている場合、--from--to無視されます。" (missing が) instead of the correct "--from--toが無視されます。"

Method: a regex scan for code-span/bracket immediately followed by ~70 common state/passive predicates found 126 unique candidates corpus-wide. Each candidate was individually verified against the English source (4-way parallel review) — 113 confirmed genuine drops and fixed, 13 correctly skipped as false positives (wrong particle direction needing に/と instead, subject already marked elsewhere in the sentence, or a pre-existing unrelated scramble needing a different fix).

94 files changed.

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, particles, spacing, and wording throughout product guides, reference pages, troubleshooting content, and release notes.
    • Improved clarity in descriptions of configuration options, limitations, metrics, errors, SQL behavior, backup and migration procedures, and operational guidance.
    • Standardized inline formatting for selected configuration names in release notes.
    • No functional behavior, configuration semantics, or technical procedures were changed.

@coderabbitai

coderabbitai Bot commented Aug 27, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

Next included review available in 38 minutes.

View limit details

Limit details: You’ve used all 4 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 61ec67ab-149d-410e-952c-44d102b1cc3b

📥 Commits

Reviewing files that changed from the base of the PR and between 707badc and 863d17a.

📒 Files selected for processing (13)
  • auto-random.md
  • best-practices/multi-column-index-best-practices.md
  • br/br-auto-tune.md
  • migrate-from-tidb-to-tidb.md
  • releases/release-3.0.2.md
  • releases/release-5.3.1.md
  • releases/release-5.4.1.md
  • schedule-replicas-by-topology-labels.md
  • sql-statements/sql-statement-explain.md
  • sql-statements/sql-statement-load-data.md
  • ticdc/ticdc-avro-protocol.md
  • ticdc/ticdc-faq.md
  • tidb-cloud/csv-config-for-import-data.md
📝 Walkthrough

Walkthrough

This documentation-only change corrects Japanese grammar, wording, and spacing across reference guides, product documentation, and release notes. It does not change functionality, configuration behavior, APIs, or technical meaning.

Changes

Japanese documentation corrections

Layer / File(s) Summary
Guide and reference wording corrections
ai/reference/*, benchmark/*, best-practices/*, br/*, dashboard/*, develop/*, functions-and-operators/*, and other documentation
Japanese particles, wording, spacing, and sentence structure were corrected across product guides and reference pages.
Release notes through version 5.4.2
releases/release-2.*.md, releases/release-3.*.md, releases/release-4.*.md, releases/release-5.*.md
Japanese grammar, typo, and inline-code formatting corrections were applied to historical release notes.
Release notes from version 6.1.0 onward
releases/release-6.*.md, releases/release-7.*.md, releases/release-8.*.md
Japanese grammar, wording, and spacing corrections were applied to later release notes.

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

Merge Risk: 🟡 Moderate · up to 707ba

The PR improves Japanese documentation by restoring dropped subject particles, but the current head still contains multiple concrete grammar and terminology errors in modified files, including malformed predicates, missing particles, unclear parameter relationships, and an incorrect feature name. These bounded documentation-correctness issues should be fixed before merge.

Suggested reviewers: qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the Japanese internationalization change and the correction of dropped subject-marker particles before predicates.
Description check ✅ Passed The description explains the change, scope, review method, affected version, related PRs, and AI involvement. The required sections are substantially complete.
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: 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. (90 skipped: 90 unsupported.)

✨ 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-ga-particles-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 qiancai 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 added a commit that referenced this pull request Aug 27, 2026
55 sites across 51 files where the topic particle は appears to be
missing immediately after a code span/bracket, before a definitional
or state predicate (becomes/is called/represents/corresponds to/is
supported/etc.).

NOT individually verified against the English source per-site, unlike
the previous を (#23579/#23611) and が (#23624) sweeps. は is far more
context-dependent than を/が (Japanese frequently and correctly omits
は when a topic is already established), so a mechanical detector has
a much higher false-positive rate here. Submitted as a draft
specifically so a human can review each site before merging.

UPDATE: user review caught a systemic false-positive class in the
になります/となります predicate category (18 sites) -- the captured
code span/bracket is the COMPLEMENT (the resulting value) of the
"becomes X" predicate, not its subject, e.g. "この機能が一般提供
(GA)となります" (the feature becomes GA) mis-edited to insert は
right before となります, producing the ungrammatical "一般提供(GA)
はとなります". All 18 sites in this predicate category were reverted;
37 sites across the other predicate categories remain.
yahonda added a commit that referenced this pull request 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 changed the title i18n(ja): fix dropped が particle before predicates i18n(ja): fix dropped subject-marker particle before predicates Aug 27, 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 28, 2026
…l-fix-dropped-ga-particles-2026-08-27

# Conflicts:
#	releases/release-2.1.10.md
#	releases/release-6.3.0.md
#	schedule-replicas-by-topology-labels.md

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


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 438a401b-dae7-4791-bb2d-b497f6adbceb

📥 Commits

Reviewing files that changed from the base of the PR and between cabd7c5 and 707badc.

📒 Files selected for processing (90)
  • ai/reference/vector-search-index.md
  • auto-random.md
  • benchmark/benchmark-tidb-using-sysbench.md
  • best-practices/multi-column-index-best-practices.md
  • best-practices/three-dc-local-read.md
  • br/br-auto-tune.md
  • br/br-monitoring-and-alert.md
  • character-set-gbk.md
  • check-before-deployment.md
  • dashboard/dashboard-profiling.md
  • dashboard/dashboard-resource-manager.md
  • develop/dev-guide-connection-parameters.md
  • develop/dev-guide-sample-application-python-sqlalchemy.md
  • dm/table-selector.md
  • functions-and-operators/string-functions.md
  • functions-and-operators/tidb-functions.md
  • metrics-schema.md
  • migrate-from-tidb-to-tidb.md
  • password-management.md
  • pipelined-dml.md
  • releases/release-2.0.3.md
  • releases/release-2.1.10.md
  • releases/release-2.1.18.md
  • releases/release-2.1.19.md
  • releases/release-2.1.2.md
  • releases/release-3.0-ga.md
  • releases/release-3.0.2.md
  • releases/release-3.0.4.md
  • releases/release-3.0.6.md
  • releases/release-4.0.0-beta.1.md
  • releases/release-4.0.0-beta.2.md
  • releases/release-4.0.0-rc.1.md
  • releases/release-4.0.16.md
  • releases/release-4.0.7.md
  • releases/release-5.0.0-rc.md
  • releases/release-5.0.6.md
  • releases/release-5.1.4.md
  • releases/release-5.2.2.md
  • releases/release-5.3.0.md
  • releases/release-5.3.1.md
  • releases/release-5.4.0.md
  • releases/release-5.4.1.md
  • releases/release-5.4.2.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.1.md
  • releases/release-6.1.7.md
  • releases/release-6.3.0.md
  • releases/release-6.5.0.md
  • releases/release-6.5.12.md
  • releases/release-6.5.4.md
  • releases/release-6.5.6.md
  • releases/release-7.1.0.md
  • releases/release-7.1.1.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.4.0.md
  • releases/release-7.5.1.md
  • releases/release-7.5.4.md
  • releases/release-7.5.5.md
  • releases/release-8.0.0.md
  • releases/release-8.5.5.md
  • schedule-replicas-by-topology-labels.md
  • shard-row-id-bits.md
  • sql-statements/sql-statement-explain.md
  • sql-statements/sql-statement-load-data.md
  • sql-statements/sql-statement-modify-column.md
  • sql-statements/sql-statement-savepoint.md
  • sql-statements/sql-statement-show-collation.md
  • sync-diff-inspector/route-diff.md
  • temporary-tables.md
  • ticdc/ticdc-avro-protocol.md
  • ticdc/ticdc-faq.md
  • ticdc/ticdc-sink-to-kafka.md
  • tidb-cloud/csv-config-for-import-data.md
  • tidb-cloud/migrate-from-mysql-using-data-migration.md
  • tidb-cloud/monitor-datadog-integration.md
  • tidb-resource-control-ru-groups.md
  • tiflash/tiflash-configuration.md
  • tiflash/use-tiflash-mpp-mode.md
  • tikv-control.md
  • tiproxy/tiproxy-traffic-replay.md
  • tiproxy/troubleshoot-tiproxy.md
  • tiup/tiup-cluster-no-sudo-mode.md
  • tiup/tiup-cluster-topology-reference.md
  • troubleshoot-cpu-issues.md
  • troubleshoot-data-inconsistency-errors.md
  • tune-region-performance.md

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

Comment thread auto-random.md Outdated
Comment thread best-practices/multi-column-index-best-practices.md Outdated
Comment thread br/br-auto-tune.md Outdated
Comment thread migrate-from-tidb-to-tidb.md Outdated
Comment thread releases/release-3.0.2.md Outdated
Comment thread sql-statements/sql-statement-explain.md Outdated
Comment thread sql-statements/sql-statement-load-data.md Outdated
Comment thread ticdc/ticdc-avro-protocol.md Outdated
Comment thread ticdc/ticdc-faq.md Outdated
Comment thread tidb-cloud/csv-config-for-import-data.md Outdated
Fix 12 remaining grammar defects flagged by CodeRabbit on PR #23624:
missing sentence boundary (auto-random.md), OR condition word order
(multi-column-index-best-practices.md), missing は/が/の/に particles
(br-auto-tune.md, migrate-from-tidb-to-tidb.md, release-3.0.2.md,
release-5.3.1.md, release-5.4.1.md, sql-statement-load-data.md,
ticdc-avro-protocol.md, ticdc-faq.md, csv-config-for-import-data.md),
mistranslated "Follower Read" feature name as a full sentence
(schedule-replicas-by-topology-labels.md), and a garbled list
separator in an EXPLAIN table row (sql-statement-explain.md). All
verified against the English source before applying.
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/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