Skip to content

i18n(ja): fix function/feature mistranslations - #23704

Open
yahonda wants to merge 7 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-function-feature-term
Open

i18n(ja): fix function/feature mistranslations#23704
yahonda wants to merge 7 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-ja-function-feature-term

Conversation

@yahonda

@yahonda yahonda commented Sep 2, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

English "function" is ambiguous and gets translated into Japanese as either 関数 (a callable SQL/programming function) or 機能 (a product feature/capability). Found via a high-precision grep pattern (a backtick-quoted identifier immediately followed by 機能) that a number of genuine SQL/API function names had been mistranslated with 機能 instead of 関数.

Fixed 26 occurrences across 24 files where the backtick-quoted identifier is a genuine callable function (SQL built-in functions like CEIL, ROUND, ABS(), DATE(), REGEXP, JSON_EXTRACT(), WEEK(), translate, stddev_pop, aggregate/window functions like row_number(), or internal Go API functions like SendRequest, GetAllMembers, reArrangeFallback, leftShift) where EN explicitly calls it a "function".

15 other candidates matching the same grep pattern were checked and confirmed already correct — these are genuine feature/mechanism names (e.g. AUTO_RANDOM feature, heartbeat feature, PreVote feature, EXPLAIN features, mysql_close() functionality — EN says "functionality" not "function" for that one) where EN itself says "feature"/"functionality", not "function".

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 terminology across monitoring, SQL function, operator, developer, and release-note documentation.
    • Improved wording and grammar for descriptions of function support, pushdown capabilities, and compatibility fixes.
    • Clarified references to functions such as Avg, row_number(), WEEK(), CURRENT_RESOURCE_GROUP(), and others.
    • Updated historical release-note descriptions without changing their documented meaning.
    • No functional behavior or product capabilities changed.

@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

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: Team

Run ID: fff1e060-a4e3-486d-8e72-ed31d140513c

📥 Commits

Reviewing files that changed from the base of the PR and between b62a015 and 5cd7043.

📒 Files selected for processing (1)
  • releases/release-4.0.0-beta.1.md

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


📝 Walkthrough

Walkthrough

The pull request updates Japanese documentation and release notes. It standardizes terminology for functions and refines support-related wording. No functional behavior or public declarations change.

Changes

Japanese terminology cleanup

Layer / File(s) Summary
Reference and guide terminology
best-practices/grafana-monitor-best-practices.md, develop/dev-guide-hybrid-oltp-and-olap-queries.md, functions-and-operators/*.md
Function names such as Avg, row_number(), WEEK(), and CURRENT_RESOURCE_GROUP() now use consistent Japanese terminology.
Release note terminology through 4.x
releases/release-2.*.md, releases/release-3.*.md, releases/release-4.*.md
Release notes correct function terminology and related support phrasing.
Release note wording from 5.x onward
releases/release-5.*.md, releases/release-6.*.md, releases/release-7.6.0.md, releases/release-8.5.5.md, releases/release-8.0.0.md
Release notes refine function and pushdown support descriptions without changing technical content.

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

Merge Risk: 🟡 Moderate · up to 5cd70

The Japanese documentation still contains two terminology and wording errors that could mislead readers about SQL functions and operators, so the PR is not merge-ready until those localized corrections are made.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies a Japanese internationalization fix for function-versus-feature mistranslations, which matches the main documentation changes.
Description check ✅ Passed The description explains the terminology issue, scope, validation of unchanged cases, affected version, AI involvement, and change-category checklist. The optional reference-link fields are blank, but…
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 terminology issue, scope, validation of unchanged cases, affected version, AI involvement, and change-category checklist. The optional reference-link fields are blank, but the required information is complete.

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

✨ 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 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 Sep 2, 2026
@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 the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Sep 2, 2026
@yahonda yahonda changed the title i18n(ja): fix function/feature (関数/機能) mistranslations i18n(ja): fix function/feature mistranslations Sep 2, 2026
@yahonda
yahonda marked this pull request as ready for review September 2, 2026 06:39
@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: 143b295c-d66a-44b6-96d3-57342a851b32

📥 Commits

Reviewing files that changed from the base of the PR and between 23d5ab9 and 9d6efe3.

📒 Files selected for processing (28)
  • best-practices/grafana-monitor-best-practices.md
  • develop/dev-guide-hybrid-oltp-and-olap-queries.md
  • functions-and-operators/date-and-time-functions.md
  • functions-and-operators/tidb-functions.md
  • releases/release-2.0.3.md
  • releases/release-2.1.10.md
  • releases/release-2.1.12.md
  • releases/release-2.1.14.md
  • releases/release-2.1.8.md
  • releases/release-3.0.2.md
  • releases/release-3.0.20.md
  • releases/release-4.0.0-beta.1.md
  • releases/release-4.0.11.md
  • releases/release-4.0.6.md
  • releases/release-4.0.7.md
  • releases/release-4.0.8.md
  • releases/release-5.0.3.md
  • releases/release-5.0.4.md
  • releases/release-5.1.1.md
  • releases/release-5.1.2.md
  • releases/release-5.2.0.md
  • releases/release-5.4.1.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.3.0.md
  • releases/release-6.4.0.md
  • releases/release-6.5.0.md
  • releases/release-7.6.0.md
  • releases/release-8.5.5.md

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

Comment thread releases/release-2.1.10.md
Comment thread releases/release-6.0.0-dmr.md Outdated
@ti-chi-bot ti-chi-bot Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Sep 2, 2026
@yahonda
yahonda force-pushed the fix-ja-function-feature-term branch from 5cd7043 to 628e0dd Compare September 3, 2026 02:09
@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 3, 2026
yahonda and others added 6 commits September 3, 2026 13:34
Fix 26 occurrences across 24 files where a backtick-quoted SQL/API
function name was mistranslated as 機能 (feature) instead of 関数
(function), per the corresponding English source.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
….10.md

EN: "Fix a bug of the BETWEEN function in the DATE/DATETIME
comparison". JA dropped "comparison" entirely and lacked any
connector between DATE and DATETIME, reading as an unnatural bare
juxtaposition instead of the intended slash-separated pair.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
16 sites across 8 files used the literal-MT construction "Xを<target>
にプッシュダウンするサポート" (a bare noun "support" trailing a
relative clause), instead of the corpus's established natural pattern
"Xの<target>へのプッシュダウンをサポート" (already used elsewhere,
e.g. release-6.3.0.md's elt function bullet).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
EN calls this a function ("Support the JSON_LENGTH(json, path)
function"), matching the file's own later mention of JSON_LENGTH() as
a function. Found via a targeted search for parenthesized identifiers
followed by feature-word, since the earlier automated sweep had
assumed identifiers with parens were low-risk and skipped them.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…-6.3.0.md

EN: "Support pushing down the HexIntArg/HexStrArg function to
TiFlash" -- confirms this is a function, matching the adjacent
leftShift/castTimeAsDuration bullets in the same list.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…1.md

Several bullets had multiple [#N](url) reference links split across
the sentence (some before the final verb, some after, sometimes in a
different order than EN), instead of grouped together as EN has them.
Fixed 3 sites: Sequence function, PD config item (2 occurrences), and
readpool.unify-read-pool; also normalized one link-order mismatch for
the SLOW_QUERY / CLUSTER_SLOW_QUERY bullet.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the fix-ja-function-feature-term branch from 628e0dd to 793b23c Compare September 3, 2026 04:36
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