Skip to content

i18n(ja): fix plain-form sentences stranded in polite prose - #23584

Open
yahonda wants to merge 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-style-register-consistency-2026-08-20
Open

i18n(ja): fix plain-form sentences stranded in polite prose#23584
yahonda wants to merge 1 commit into
pingcap:i18n-ja-release-8.5from
yahonda:fix-style-register-consistency-2026-08-20

Conversation

@yahonda

@yahonda yahonda commented Aug 20, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Corpus-wide scan for です/ます (polite) vs だ/である (plain/literary) sentence-register mixing: files that are overwhelmingly polite but have a stray plain-style sentence or paragraph, which reads jarring against the surrounding voice. Each site verified against EN and fixed to match the file's dominant polite register (9 files):

  • releases/release-6.5.0.md: not just a register issue - the clause was also word-order scrambled and missing ます entirely, garbling which statement types are supported. Rewritten to match EN.
  • develop/java-app-best-practices.md, develop/dev-guide-connection-parameters.md, information-schema/information-schema-inspection-result.md, optimistic-transaction.md, grafana-pd-dashboard.md: one stray plain-ending sentence each, mismatching immediate sibling sentences/bullets.
  • tidb-lightning/tidb-lightning-physical-import-mode-usage.md: two plain sentences in the same line fixed together.
  • dr-secondary-cluster.md: a whole 4-sentence paragraph was plain-style, sandwiched between polite text - fixed all 4 sentences together.
  • pessimistic-transaction.md: a 3-sentence plain paragraph plus one bullet mismatching its sibling above.

This is the first batch from an ongoing scan; more candidates (bullet-list/table-cell style, which need per-list context judgment) are still being verified and may follow as additional commits on this PR.

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 wording, punctuation, and polite sentence endings across guides, references, troubleshooting content, and release notes.
    • Clarified instructions and technical descriptions while preserving documented behavior and procedures.
    • Improved troubleshooting guidance, including bug-report instructions, step organization, and punctuation consistency.
    • Corrected documentation details for TiCDC upgrade requirements, statistics behavior, network latency examples, and supported non-transactional DML.

@coderabbitai

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

The pull request updates Japanese documentation across TiDB guides and reference pages. Most changes standardize polite sentence endings, grammar, and punctuation. Troubleshooting and release-note descriptions also receive wording and factual corrections.

Changes

Documentation wording alignment

Layer / File(s) Summary
Japanese documentation wording and grammar
ai/*, develop/*, alert-rules.md, dashboard/*, dm/*, best-practices/*, *.md
Updates sentence endings, punctuation, grammar, instructions, descriptions, and terminology across TiDB documentation.
Troubleshooting and operational guidance
tidb-troubleshooting-map.md, troubleshoot-*.md, statistics.md, ticdc/*, tiproxy/*
Refines troubleshooting wording, bug-report instructions, subsection organization, upgrade conditions, and partition-lock descriptions.
Release and TiDB Cloud documentation
releases/*, tidb-cloud/*, tidb-lightning/*
Standardizes Japanese release-note, cloud-procedure, migration, and import-documentation wording. One release note corrects the documented support statement for non-transactional INSERT, REPLACE, and UPDATE from TiDB 6.5.0.

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

Merge Risk: 🟠 High · up to 18ecf

This PR changes Japanese documentation wording and formatting across 110 files, but several edits could still mislead users about supported SQL, compliance scope, execution behavior, version applicability, or troubleshooting procedures that may leave garbage collection disabled. These concrete correctness and operational risks should be fixed before merging; the remaining formatting issues are minor.

Suggested reviewers: qiancai

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the Japanese documentation register-consistency fix.
Description check ✅ Passed The description covers the changes, affected version, AI involvement, and applicable change categories; optional reference links are blank.
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 files. (110 skipped: 110 unsupported.)
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.
✨ 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 20, 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 icemap 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 missing-translation-status This PR does not have translation status info. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. area/develop This PR relates to the area of TiDB App development. labels Aug 20, 2026
@pingcap-cla-assistant

pingcap-cla-assistant Bot commented Aug 20, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@ti-chi-bot ti-chi-bot Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Aug 20, 2026
@yahonda
yahonda marked this pull request as draft August 20, 2026 08:29
@ti-chi-bot ti-chi-bot Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 20, 2026
@yahonda yahonda changed the title i18n(ja): fix だ/である plain-style sentences stranded in polite prose i18n(ja): fix plain-form sentences stranded in polite prose Aug 24, 2026
@yahonda
yahonda marked this pull request as ready for review August 24, 2026 01:02
@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 24, 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: 12


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 68232524-0be5-4483-b712-2753ccac0e1e

📥 Commits

Reviewing files that changed from the base of the PR and between b0387bb and 4288fb0.

📒 Files selected for processing (110)
  • ai/concepts/vector-search-overview.md
  • ai/integrations/tidb-mcp-server.md
  • ai/quickstart-via-python.md
  • alert-rules.md
  • as-of-timestamp.md
  • backup-and-restore-using-dumpling-lightning.md
  • best-practices/_index.md
  • best-practices/tidb-best-practices.md
  • br/backup-and-restore-overview.md
  • check-before-deployment.md
  • clinic/clinic-data-instruction-for-tiup.md
  • configure-load-base-split.md
  • dashboard/dashboard-profiling.md
  • dashboard/top-sql.md
  • develop/dev-guide-connection-parameters.md
  • develop/dev-guide-sample-application-golang-sql-driver.md
  • develop/dev-guide-sample-application-java-jdbc.md
  • develop/dev-guide-sample-application-python-django.md
  • develop/dev-guide-sample-application-python-mysql-connector.md
  • develop/dev-guide-sample-application-python-mysqlclient.md
  • develop/dev-guide-sample-application-python-pymysql.md
  • develop/dev-guide-tidb-basics.md
  • develop/java-app-best-practices.md
  • develop/serverless-driver-kysely-example.md
  • dm/dm-error-handling.md
  • dm/dm-handle-alerts.md
  • dm/dm-webui-guide.md
  • dr-secondary-cluster.md
  • functions-and-operators/encryption-and-compression-functions.md
  • glossary.md
  • grafana-pd-dashboard.md
  • grafana-tidb-dashboard.md
  • identify-slow-queries.md
  • information-schema/information-schema-inspection-result.md
  • information-schema/information-schema-user-privileges.md
  • metrics-schema.md
  • migrate-from-csv-files-to-tidb.md
  • migrate-from-parquet-files-to-tidb.md
  • migrate-large-mysql-to-tidb.md
  • mysql-compatibility.md
  • online-unsafe-recovery.md
  • optimistic-transaction.md
  • partitioned-table.md
  • pd-control.md
  • performance-tuning-methods.md
  • pessimistic-transaction.md
  • post-installation-check.md
  • quick-start-with-tidb.md
  • read-historical-data.md
  • releases/release-5.0.0.md
  • releases/release-5.1.0.md
  • releases/release-5.2.0.md
  • releases/release-5.4.0.md
  • releases/release-6.2.0.md
  • releases/release-6.4.0.md
  • releases/release-6.5.0.md
  • replicate-between-primary-and-secondary-clusters.md
  • scale-tidb-using-tiup.md
  • schema-cache.md
  • sql-statements/sql-statement-alter-user.md
  • sql-statements/sql-statement-create-index.md
  • sql-statements/sql-statement-explain-analyze.md
  • sql-statements/sql-statement-select.md
  • sql-tuning-best-practice.md
  • statement-summary-tables.md
  • statistics.md
  • system-variables.md
  • ticdc/deploy-ticdc.md
  • ticdc/ticdc-overview.md
  • ticdc/ticdc-sink-to-mysql.md
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/backup-and-restore-concepts.md
  • tidb-cloud/backup-and-restore.md
  • tidb-cloud/changefeed-sink-to-apache-kafka.md
  • tidb-cloud/changefeed-sink-to-apache-pulsar.md
  • tidb-cloud/changefeed-sink-to-mysql.md
  • tidb-cloud/database-schema-concepts.md
  • tidb-cloud/get-started-with-cli.md
  • tidb-cloud/integrate-tidbcloud-with-airbyte.md
  • tidb-cloud/migrate-from-mysql-using-aws-dms.md
  • tidb-cloud/migrate-from-mysql-using-data-migration.md
  • tidb-cloud/migrate-from-op-tidb.md
  • tidb-cloud/monitor-built-in-alerting.md
  • tidb-cloud/notifications.md
  • tidb-cloud/premium/migrate-from-op-tidb-premium.md
  • tidb-cloud/premium/premium-export.md
  • tidb-cloud/releases/release-notes-2024.md
  • tidb-cloud/security-concepts.md
  • tidb-cloud/set-up-vpc-peering-connections.md
  • tidb-cloud/tidb-cloud-glossary.md
  • tidb-configuration-file.md
  • tidb-external-ts.md
  • tidb-lightning/tidb-lightning-data-source.md
  • tidb-lightning/tidb-lightning-distributed-import.md
  • tidb-lightning/tidb-lightning-physical-import-mode-usage.md
  • tidb-performance-tuning-config.md
  • tidb-resource-control-background-tasks.md
  • tidb-troubleshooting-map.md
  • tiflash/tiflash-pipeline-model.md
  • tiflash/troubleshoot-tiflash.md
  • tikv-configuration-file.md
  • tikv-in-memory-engine.md
  • tiproxy/tiproxy-grafana.md
  • tiproxy/tiproxy-overview.md
  • tiproxy/tiproxy-traffic-replay.md
  • transaction-isolation-levels.md
  • troubleshoot-cpu-issues.md
  • troubleshoot-tidb-cluster.md
  • troubleshoot-tidb-oom.md
  • user-account-management.md

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

Comment thread alert-rules.md Outdated
Comment thread br/backup-and-restore-overview.md Outdated
Comment thread dashboard/top-sql.md Outdated
Comment thread develop/dev-guide-sample-application-golang-sql-driver.md Outdated
Comment thread information-schema/information-schema-inspection-result.md
Comment thread sql-statements/sql-statement-create-index.md Outdated
Comment thread sql-statements/sql-statement-explain-analyze.md Outdated
Comment thread system-variables.md Outdated
Comment thread tidb-troubleshooting-map.md Outdated
Comment thread tidb-troubleshooting-map.md
@yahonda
yahonda marked this pull request as draft August 24, 2026 02:08
@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 24, 2026
@yahonda
yahonda force-pushed the fix-style-register-consistency-2026-08-20 branch from 056ab38 to 18ecf12 Compare August 24, 2026 02:20
@yahonda
yahonda marked this pull request as ready for review August 24, 2026 03:01
@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 24, 2026
@coderabbitai

coderabbitai Bot commented Aug 24, 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: 10


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 1fb0656e-0ab9-4186-be5e-554c127e4191

📥 Commits

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

📒 Files selected for processing (110)
  • ai/concepts/vector-search-overview.md
  • ai/integrations/tidb-mcp-server.md
  • ai/quickstart-via-python.md
  • alert-rules.md
  • as-of-timestamp.md
  • backup-and-restore-using-dumpling-lightning.md
  • best-practices/_index.md
  • best-practices/tidb-best-practices.md
  • br/backup-and-restore-overview.md
  • check-before-deployment.md
  • clinic/clinic-data-instruction-for-tiup.md
  • configure-load-base-split.md
  • dashboard/dashboard-profiling.md
  • dashboard/top-sql.md
  • develop/dev-guide-connection-parameters.md
  • develop/dev-guide-sample-application-golang-sql-driver.md
  • develop/dev-guide-sample-application-java-jdbc.md
  • develop/dev-guide-sample-application-python-django.md
  • develop/dev-guide-sample-application-python-mysql-connector.md
  • develop/dev-guide-sample-application-python-mysqlclient.md
  • develop/dev-guide-sample-application-python-pymysql.md
  • develop/dev-guide-tidb-basics.md
  • develop/java-app-best-practices.md
  • develop/serverless-driver-kysely-example.md
  • dm/dm-error-handling.md
  • dm/dm-handle-alerts.md
  • dm/dm-webui-guide.md
  • dr-secondary-cluster.md
  • functions-and-operators/encryption-and-compression-functions.md
  • glossary.md
  • grafana-pd-dashboard.md
  • grafana-tidb-dashboard.md
  • identify-slow-queries.md
  • information-schema/information-schema-inspection-result.md
  • information-schema/information-schema-user-privileges.md
  • metrics-schema.md
  • migrate-from-csv-files-to-tidb.md
  • migrate-from-parquet-files-to-tidb.md
  • migrate-large-mysql-to-tidb.md
  • mysql-compatibility.md
  • online-unsafe-recovery.md
  • optimistic-transaction.md
  • partitioned-table.md
  • pd-control.md
  • performance-tuning-methods.md
  • pessimistic-transaction.md
  • post-installation-check.md
  • quick-start-with-tidb.md
  • read-historical-data.md
  • releases/release-5.0.0.md
  • releases/release-5.1.0.md
  • releases/release-5.2.0.md
  • releases/release-5.4.0.md
  • releases/release-6.2.0.md
  • releases/release-6.4.0.md
  • releases/release-6.5.0.md
  • replicate-between-primary-and-secondary-clusters.md
  • scale-tidb-using-tiup.md
  • schema-cache.md
  • sql-statements/sql-statement-alter-user.md
  • sql-statements/sql-statement-create-index.md
  • sql-statements/sql-statement-explain-analyze.md
  • sql-statements/sql-statement-select.md
  • sql-tuning-best-practice.md
  • statement-summary-tables.md
  • statistics.md
  • system-variables.md
  • ticdc/deploy-ticdc.md
  • ticdc/ticdc-overview.md
  • ticdc/ticdc-sink-to-mysql.md
  • tidb-cloud/architecture-concepts.md
  • tidb-cloud/backup-and-restore-concepts.md
  • tidb-cloud/backup-and-restore.md
  • tidb-cloud/changefeed-sink-to-apache-kafka.md
  • tidb-cloud/changefeed-sink-to-apache-pulsar.md
  • tidb-cloud/changefeed-sink-to-mysql.md
  • tidb-cloud/database-schema-concepts.md
  • tidb-cloud/get-started-with-cli.md
  • tidb-cloud/integrate-tidbcloud-with-airbyte.md
  • tidb-cloud/migrate-from-mysql-using-aws-dms.md
  • tidb-cloud/migrate-from-mysql-using-data-migration.md
  • tidb-cloud/migrate-from-op-tidb.md
  • tidb-cloud/monitor-built-in-alerting.md
  • tidb-cloud/notifications.md
  • tidb-cloud/premium/migrate-from-op-tidb-premium.md
  • tidb-cloud/premium/premium-export.md
  • tidb-cloud/releases/release-notes-2024.md
  • tidb-cloud/security-concepts.md
  • tidb-cloud/set-up-vpc-peering-connections.md
  • tidb-cloud/tidb-cloud-glossary.md
  • tidb-configuration-file.md
  • tidb-external-ts.md
  • tidb-lightning/tidb-lightning-data-source.md
  • tidb-lightning/tidb-lightning-distributed-import.md
  • tidb-lightning/tidb-lightning-physical-import-mode-usage.md
  • tidb-performance-tuning-config.md
  • tidb-resource-control-background-tasks.md
  • tidb-troubleshooting-map.md
  • tiflash/tiflash-pipeline-model.md
  • tiflash/troubleshoot-tiflash.md
  • tikv-configuration-file.md
  • tikv-in-memory-engine.md
  • tiproxy/tiproxy-grafana.md
  • tiproxy/tiproxy-overview.md
  • tiproxy/tiproxy-traffic-replay.md
  • transaction-isolation-levels.md
  • troubleshoot-cpu-issues.md
  • troubleshoot-tidb-cluster.md
  • troubleshoot-tidb-oom.md
  • user-account-management.md

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

Comment thread ai/integrations/tidb-mcp-server.md Outdated
Comment thread develop/dev-guide-sample-application-python-mysqlclient.md Outdated
Comment thread dm/dm-error-handling.md Outdated
Comment thread metrics-schema.md Outdated
Comment thread mysql-compatibility.md Outdated
Comment thread performance-tuning-methods.md Outdated
Comment thread releases/release-6.5.0.md
Comment thread tidb-cloud/changefeed-sink-to-apache-pulsar.md Outdated
@yahonda
yahonda force-pushed the fix-style-register-consistency-2026-08-20 branch from 18ecf12 to dd0bb47 Compare August 25, 2026 00:19
@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-style-register-consistency-2026-08-20 branch from dd0bb47 to c519034 Compare August 26, 2026 01:57
Rebase PR pingcap#23584 onto the advanced i18n-ja-release-8.5 base using the
content-preserving line-merge method, and re-apply katakana compound-word
joins (PR pingcap#23577) that were reverted where this branch also touched the
same lines.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the fix-style-register-consistency-2026-08-20 branch from c519034 to 98d6744 Compare August 27, 2026 04:30
@ti-chi-bot ti-chi-bot Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Aug 27, 2026
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