Skip to content

i18n(ja): fix clause/statement label swaps in 4 files - #23671

Merged
qiancai merged 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-clause-mistranslated-as-statement
Aug 31, 2026
Merged

i18n(ja): fix clause/statement label swaps in 4 files#23671
qiancai merged 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-clause-mistranslated-as-statement

Conversation

@yahonda

@yahonda yahonda commented Aug 31, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Fixes genuine mistranslations (誤訳, not 表記揺れ) found while doing an unrelated statement-terminology
sweep (#23668). In 4 files, the JA translation swapped which SQL keyword is the "statement" and which
is the "clause" (or, in one case, mislabeled a column as a clause), diverging from what the EN source
actually says:

  • develop/dev-guide-update-data.md: EN says "Always specify the WHERE clause in the UPDATE
    statement." JA had it backwards (WHEREステートメント / UPDATE句) — fixed to UPDATEステートメント /
    WHERE句.
  • develop/dev-guide-delete-data.md: same swap, EN says "Always specify the WHERE clause in the
    DELETE statement." — fixed the same way.
  • functions-and-operators/miscellaneous-functions.md: EN says "TiDB returns an error for the first
    SELECT statement because the id column is non-aggregated and not included in the GROUP BY
    clause." JA had scrambled all three labels (id句, GROUP BYステートメント, SELECT列) — fixed to
    match EN (id列, GROUP BY句, SELECTステートメント).
  • releases/release-7.0.0.md: EN says "When processing a SELECT statement with filter conditions
    (WHERE clause)..." JA had merged SELECT/WHERE into one garbled compound and dropped the
    "with filter conditions" framing — reworded to match EN's structure.

Each fix verified against upstream/release-8.5 before applying. A broader corpus scan for
`WHERE`/`JOIN`/`ORDER BY`/`GROUP BY` immediately followed by "statement" found 16 more sites
across other files (release notes, glossary.md, several develop/ guides, etc.) — those were all
checked individually and turned out to be faithful 1:1 renderings of the EN source, which itself
uses "statement" loosely for these clauses in many places. Those are intentionally left untouched.

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
    • Corrected Japanese best-practice guidance for safely using DELETE and UPDATE statements with WHERE clauses.
    • Clarified the behavior and error conditions of the ANY_VALUE() function.
    • Fixed a malformed parenthetical phrase in the TiDB 7.0.0 release notes describing TiFlash late materialization.

Fix genuine mistranslations where WHERE/GROUP BY/SELECT/id were
mislabeled relative to their EN source (clause called statement,
column called clause, or the wrong keyword given the "statement"
label entirely):

- dev-guide-update-data.md, dev-guide-delete-data.md: EN says "specify
  the WHERE clause in the UPDATE/DELETE statement", JA had the WHERE/
  UPDATE (or WHERE/DELETE) statement/clause labels swapped.
- functions-and-operators/miscellaneous-functions.md: EN says the first
  SELECT statement errors because the id column isn't in the GROUP BY
  clause; JA had scrambled all three labels (id called a clause, GROUP
  BY called a statement, SELECT called a column).
- releases/release-7.0.0.md: EN says "a SELECT statement with filter
  conditions (WHERE clause)"; JA had merged SELECT and WHERE into one
  garbled compound and dropped the filter-conditions framing.

Verified against upstream/release-8.5 for each site. A broader corpus
scan for `WHERE`/`JOIN`/`ORDER BY`/`GROUP BY`+statement found 16 more
sites across other files that turned out to be faithful renderings of
EN's own "statement" wording for these clauses (EN itself uses this
terminology loosely in many places) -- those are correctly left as-is.
@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 31, 2026
@ti-chi-bot

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

Copy link
Copy Markdown

Review Change Stack

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: 35cda6c5-82bb-4d8a-abb0-f26982f84676

📥 Commits

Reviewing files that changed from the base of the PR and between cabd7c5 and 20dcdc8.

📒 Files selected for processing (4)
  • develop/dev-guide-delete-data.md
  • develop/dev-guide-update-data.md
  • functions-and-operators/miscellaneous-functions.md
  • releases/release-7.0.0.md

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


📝 Walkthrough

Walkthrough

Four documentation statements were corrected. The changes update SQL best-practice wording, clarify the ANY_VALUE() description, and fix a malformed TiFlash release-note phrase. No code or public declarations changed.

Changes

Documentation corrections

Layer / File(s) Summary
SQL guidance corrections
develop/dev-guide-delete-data.md, develop/dev-guide-update-data.md
The DELETE and UPDATE best-practice statements now correctly require a WHERE clause.
Reference and release-note wording
functions-and-operators/miscellaneous-functions.md, releases/release-7.0.0.md
The ANY_VALUE() description and TiFlash late-materialization release-note wording now match the intended terminology and grammar.

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

Merge Risk: ⚪ Minimal · up to 20dcd

This PR corrects mislabeled SQL terminology and sentence structure in four Japanese documentation files without changing product behavior; no actionable merge-blocking risk remains beyond normal checks and review.

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 changes and the correction of clause/statement labels across four files. It also covers the primary nature of the changes, although one f…
Description check ✅ Passed The description explains the four documentation corrections, their source comparison, affected version, AI involvement, and unchanged related sites. The required change and version sections are comple…
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: Title check

Explanation

The title clearly identifies the Japanese internationalization changes and the correction of clause/statement labels across four files. It also covers the primary nature of the changes, although one file includes broader wording corrections.

Full details: Description check

Explanation

The description explains the four documentation corrections, their source comparison, affected version, AI involvement, and unchanged related sites. The required change and version sections are completed. The reference-link fields are blank, but this is non-critical.

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. (4 skipped: 4 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 Aug 31, 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 lilin90 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/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Aug 31, 2026
@yahonda
yahonda marked this pull request as ready for review August 31, 2026 01:46
@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 31, 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 31, 2026
@ti-chi-bot ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Aug 31, 2026
@qiancai
qiancai merged commit adfeb1f into pingcap:i18n-ja-release-8.5 Aug 31, 2026
5 of 9 checks passed
@ti-chi-bot

ti-chi-bot Bot commented Aug 31, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-08-31 03:38:09.577078396 +0000 UTC m=+1077724.748172506: ☑️ agreed by qiancai.

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/XS Denotes a PR that changes 0-9 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