Skip to content

i18n(ja): unify configuration file/parameter terminology - #23828

Closed
yahonda wants to merge 7 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-config-3rd-form
Closed

i18n(ja): unify configuration file/parameter terminology#23828
yahonda wants to merge 7 commits into
pingcap:i18n-ja-release-8.5from
yahonda:fix-config-3rd-form

Conversation

@yahonda

@yahonda yahonda commented Sep 11, 2026

Copy link
Copy Markdown
Member

First-time contributors' checklist

What is changed, added or deleted? (Required)

Unifies the multi-way split rendering of "configuration" (file, parameter, item, flag, option, and other compounds, plus standalone/bare use) across the corpus, consistent with the already-decided direction for configuration item/parameter/option compounds (PR #23596).

First commit — file/parameter axis:

  • コンフィグレーションファイル設定ファイル (166 occurrences)
  • 構成ファイル設定ファイル (343 occurrences)
  • コンフィグレーションパラメータ設定パラメータ (37 occurrences)
  • 設定パラメーター (long-vowel variant) → 設定パラメータ (settled independently: corpus-wide パラメータ vs パラメーター is 2315 vs 133, ~95% no long vowel)

Second commit — everything else (item/flag/option/guide/method/other compounds, plus bare standalone use in headings, TOC labels, and prose):

  • 193 occurrences / 83 files

512 + 193 = 705 occurrences / ~300 files total, all line-count-symmetric diffs. Heading anchors (English-derived, e.g. {#configuration}) are unchanged — only the visible text was updated.

Two sites were handled as manual exceptions rather than a straight substitution:

  • tidb-upgrade-migration-guide.md: a checklist bullet's label was itself the compound term, which would have produced a duplicated word if substituted literally; shortened to match sibling bullets' label style instead.
  • tidb-cloud/csv-config-for-import-data.md: kept this file's own already-established term instead, since its H1/summary/title all independently agree on it and substituting here would have left the file self-contradictory rather than more consistent.

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

@ti-chi-bot ti-chi-bot Bot added the area/develop This PR relates to the area of TiDB App development. label Sep 11, 2026
@coderabbitai

coderabbitai Bot commented Sep 11, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 265 files, which is 115 over the limit of 150.

To get a review, reduce the PR to 150 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 3c8910f6-af5f-4e7e-b10d-daa82c48b0be

📥 Commits

Reviewing files that changed from the base of the PR and between 645c2ff and 36f805c.

📒 Files selected for processing (265)
  • TOC-tidb-cloud-essential.md
  • TOC-tidb-cloud-starter.md
  • TOC-tidb-cloud.md
  • TOC.md
  • _index.md
  • ai/integrations/tidb-mcp-server.md
  • benchmark/benchmark-tidb-using-sysbench.md
  • benchmark/v3.0-performance-benchmarking-with-sysbench.md
  • best-practices/haproxy-best-practices.md
  • best-practices/three-nodes-hybrid-deployment.md
  • best-practices/tidb-partitioned-tables-best-practices.md
  • br/backup-and-restore-storages.md
  • br/br-monitoring-and-alert.md
  • cached-tables.md
  • check-before-deployment.md
  • clinic/clinic-data-instruction-for-tiup.md
  • clinic/clinic-introduction.md
  • clinic/clinic-user-guide-for-tiup.md
  • command-line-flags-for-pd-configuration.md
  • command-line-flags-for-scheduling-configuration.md
  • command-line-flags-for-tidb-configuration.md
  • command-line-flags-for-tikv-configuration.md
  • command-line-flags-for-tso-configuration.md
  • configure-placement-rules.md
  • coprocessor-cache.md
  • dashboard/dashboard-diagnostics-report.md
  • dashboard/dashboard-faq.md
  • dashboard/dashboard-ops-reverse-proxy.md
  • dashboard/dashboard-resource-manager.md
  • deploy-monitoring-services.md
  • develop/dev-guide-aws-appflow-integration.md
  • develop/dev-guide-insert-data.md
  • develop/dev-guide-optimistic-and-pessimistic-transaction.md
  • develop/dev-guide-prepared-statement.md
  • develop/dev-guide-proxysql-integration.md
  • develop/dev-guide-third-party-tools-compatibility.md
  • dm/deploy-a-dm-cluster-using-binary.md
  • dm/deploy-a-dm-cluster-using-tiup-offline.md
  • dm/deploy-a-dm-cluster-using-tiup.md
  • dm/dm-best-practices.md
  • dm/dm-binlog-event-filter.md
  • dm/dm-block-allow-table-lists.md
  • dm/dm-config-overview.md
  • dm/dm-continuous-data-validation.md
  • dm/dm-customized-secret-key.md
  • dm/dm-enable-tls.md
  • dm/dm-export-import-config.md
  • dm/dm-faq.md
  • dm/dm-generate-self-signed-certificates.md
  • dm/dm-glossary.md
  • dm/dm-handle-performance-issues.md
  • dm/dm-hardware-and-software-requirements.md
  • dm/dm-manage-source.md
  • dm/dm-master-configuration-file.md
  • dm/dm-online-ddl-tool-support.md
  • dm/dm-open-api.md
  • dm/dm-precheck.md
  • dm/dm-source-configuration-file.md
  • dm/dm-task-configuration-guide.md
  • dm/dm-tune-configuration.md
  • dm/dm-worker-configuration-file.md
  • dm/feature-shard-merge-optimistic.md
  • dm/feature-shard-merge.md
  • dm/maintain-dm-using-tiup.md
  • dm/manually-handling-sharding-ddl-locks.md
  • dm/manually-upgrade-dm-1.0-to-2.0.md
  • dm/migrate-data-using-dm.md
  • dm/quick-start-create-source.md
  • dm/quick-start-create-task.md
  • dm/quick-start-with-dm.md
  • dm/relay-log.md
  • dm/task-configuration-file-full.md
  • dm/usage-scenario-master-slave-switch.md
  • dr-multi-replica.md
  • dynamic-config.md
  • enable-disk-spill-encrypt.md
  • enable-tls-between-clients-and-servers.md
  • encryption-at-rest.md
  • explain-joins.md
  • faq/high-reliability-faq.md
  • filter-binlog-event.md
  • filter-dml-event.md
  • garbage-collection-configuration.md
  • generate-self-signed-certificates.md
  • geo-distributed-deployment-topology.md
  • get-started-with-tidb-lightning.md
  • hybrid-deployment-topology.md
  • information-schema/information-schema-inspection-result.md
  • maintain-tidb-using-tiup.md
  • migrate-aurora-to-tidb.md
  • migrate-from-csv-files-to-tidb.md
  • migrate-from-sql-files-to-tidb.md
  • migrate-from-tidb-to-mysql.md
  • migrate-from-tidb-to-tidb.md
  • migrate-from-vitess.md
  • migrate-large-mysql-shards-to-tidb.md
  • migrate-large-mysql-to-tidb.md
  • migrate-small-mysql-shards-to-tidb.md
  • migrate-small-mysql-to-tidb.md
  • migrate-with-more-columns-downstream.md
  • migrate-with-pt-ghost.md
  • minimal-deployment-topology.md
  • multi-data-centers-in-one-city-deployment.md
  • pd-configuration-file.md
  • pd-microservices-deployment-topology.md
  • performance-tuning-overview.md
  • production-deployment-using-tiup.md
  • quick-start-with-tidb.md
  • releases/release-2.0-ga.md
  • releases/release-2.0-rc.1.md
  • releases/release-2.0-rc.3.md
  • releases/release-2.0.4.md
  • releases/release-2.1.1.md
  • releases/release-2.1.16.md
  • releases/release-2.1.17.md
  • releases/release-2.1.18.md
  • releases/release-3.0.2.md
  • releases/release-3.0.4.md
  • releases/release-3.1.0-beta.2.md
  • releases/release-4.0-ga.md
  • releases/release-4.0.0-beta.1.md
  • releases/release-4.0.3.md
  • releases/release-5.0.0.md
  • releases/release-5.1.0.md
  • releases/release-5.2.0.md
  • releases/release-5.3.0.md
  • releases/release-5.4.0.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.4.md
  • releases/release-6.2.0.md
  • releases/release-6.3.0.md
  • releases/release-6.4.0.md
  • releases/release-6.5.0.md
  • releases/release-6.5.1.md
  • releases/release-6.5.6.md
  • releases/release-6.6.0.md
  • releases/release-7.0.0.md
  • releases/release-7.1.0.md
  • releases/release-7.1.3.md
  • releases/release-7.2.0.md
  • releases/release-7.3.0.md
  • releases/release-7.4.0.md
  • releases/release-7.5.0.md
  • releases/release-7.6.0.md
  • releases/release-8.0.0.md
  • releases/release-8.1.0.md
  • releases/release-8.2.0.md
  • releases/release-8.3.0.md
  • releases/release-8.4.0.md
  • releases/release-8.5.0.md
  • releases/release-8.5.4.md
  • releases/release-8.5.5.md
  • releases/release-8.5.6.md
  • releases/release-8.5.7.md
  • replicate-between-primary-and-secondary-clusters.md
  • replicate-data-to-kafka.md
  • resources/doc-templates/template-task.md
  • scale-microservices-using-tiup.md
  • scale-tidb-using-tiup.md
  • schedule-replicas-by-topology-labels.md
  • scheduling-configuration-file.md
  • sql-statements/sql-statement-import-into.md
  • sql-statements/sql-statement-lock-tables-and-unlock-tables.md
  • sql-statements/sql-statement-split-region.md
  • statement-summary-tables.md
  • storage-engine/titan-configuration.md
  • sync-diff-inspector/sync-diff-inspector-overview.md
  • system-variable-reference.md
  • system-variables.md
  • three-data-centers-in-two-cities-deployment.md
  • ticdc-deployment-topology.md
  • ticdc/deploy-ticdc.md
  • ticdc/integrate-confluent-using-ticdc.md
  • ticdc/ticdc-architecture.md
  • ticdc/ticdc-bidirectional-replication.md
  • ticdc/ticdc-changefeed-config.md
  • ticdc/ticdc-classic-architecture.md
  • ticdc/ticdc-ddl.md
  • ticdc/ticdc-faq.md
  • ticdc/ticdc-integrity-check.md
  • ticdc/ticdc-manage-changefeed.md
  • ticdc/ticdc-open-api-v2.md
  • ticdc/ticdc-server-config.md
  • ticdc/ticdc-sink-to-kafka.md
  • ticdc/ticdc-sink-to-mysql.md
  • ticdc/ticdc-sink-to-pulsar.md
  • ticdc/ticdc-upstream-downstream-check.md
  • ticdc/troubleshoot-ticdc.md
  • tidb-cloud/csv-config-for-import-data.md
  • tidb-cloud/data-service-app-config-files.md
  • tidb-cloud/data-service-concepts.md
  • tidb-cloud/data-service-get-started.md
  • tidb-cloud/data-service-manage-data-app.md
  • tidb-cloud/data-service-manage-github-connection.md
  • tidb-cloud/integrate-tidbcloud-with-dbt.md
  • tidb-cloud/migrate-from-mysql-using-data-migration.md
  • tidb-cloud/migrate-from-op-tidb.md
  • tidb-cloud/migrate-sql-shards.md
  • tidb-cloud/optimize-resource-allocation.md
  • tidb-cloud/premium/migrate-from-op-tidb-premium.md
  • tidb-cloud/setup-azure-self-hosted-kafka-private-link-service.md
  • tidb-cloud/terraform-migrate-cluster-resource.md
  • tidb-cloud/terraform-tidbcloud-provider-overview.md
  • tidb-cloud/terraform-use-cluster-resource.md
  • tidb-cloud/terraform-use-dedicated-cluster-resource.md
  • tidb-cloud/terraform-use-dedicated-network-container-resource.md
  • tidb-cloud/terraform-use-dedicated-private-endpoint-connection-resource.md
  • tidb-cloud/terraform-use-dedicated-vpc-peering-resource.md
  • tidb-cloud/terraform-use-serverless-branch-resource.md
  • tidb-cloud/terraform-use-serverless-cluster-resource-manage-essential.md
  • tidb-cloud/terraform-use-serverless-cluster-resource.md
  • tidb-cloud/terraform-use-serverless-export-resource.md
  • tidb-cloud/terraform-use-sql-user-resource.md
  • tidb-cloud/ticloud-config-edit.md
  • tidb-cloud/ticloud-serverless-audit-log-config-describe.md
  • tidb-cloud/ticloud-serverless-audit-log-config-update.md
  • tidb-cloud/ticloud-serverless-audit-log-download.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-create.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-delete.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-describe.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-list.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-template.md
  • tidb-cloud/ticloud-serverless-audit-log-filter-rule-update.md
  • tidb-cloud/tidb-cloud-connect-aws-dms.md
  • tidb-cloud/tidb-cloud-dm-precheck-and-troubleshooting.md
  • tidb-cloud/tidb-cloud-performance-reference.md
  • tidb-cloud/v8.5-performance-highlights.md
  • tidb-configuration-file.md
  • tidb-lightning/data-import-best-practices.md
  • tidb-lightning/import-into-vs-tidb-lightning.md
  • tidb-lightning/tidb-lightning-compatibility-and-scenarios.md
  • tidb-lightning/tidb-lightning-configuration.md
  • tidb-lightning/tidb-lightning-data-source.md
  • tidb-lightning/tidb-lightning-distributed-import.md
  • tidb-lightning/tidb-lightning-faq.md
  • tidb-lightning/tidb-lightning-logical-import-mode-usage.md
  • tidb-performance-tuning-config.md
  • tidb-upgrade-migration-guide.md
  • tiflash-deployment-topology.md
  • tiflash/create-tiflash-replicas.md
  • tiflash/tiflash-command-line-flags.md
  • tiflash/tiflash-configuration.md
  • tiflash/tiflash-disaggregated-and-s3.md
  • tikv-configuration-file.md
  • tikv-control.md
  • tiproxy/tiproxy-command-line-flags.md
  • tiproxy/tiproxy-configuration.md
  • tiproxy/tiproxy-deployment-topology.md
  • tiproxy/tiproxy-overview.md
  • tiproxy/tiproxy-performance-test.md
  • tiup/customized-montior-in-tiup-environment.md
  • tiup/tiup-cluster-no-sudo-mode.md
  • tiup/tiup-cluster-topology-reference.md
  • tiup/tiup-command-telemetry.md
  • tiup/tiup-component-cluster-deploy.md
  • tiup/tiup-component-cluster-import.md
  • tiup/tiup-component-cluster-patch.md
  • tiup/tiup-component-cluster-upgrade.md
  • tiup/tiup-component-dm-patch.md
  • tiup/tiup-dm-topology-reference.md
  • tso-configuration-file.md
  • two-data-centers-in-one-city-deployment.md
  • upgrade-tidb-using-tiup.md
  • user-account-management.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


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 Sep 11, 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/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Sep 11, 2026
@yahonda
yahonda marked this pull request as draft September 11, 2026 01:24
@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 11, 2026
@yahonda yahonda changed the title i18n(ja): unify configuration file/parameter notation to 設定 i18n(ja): unify configuration file/parameter terminology Sep 11, 2026
Unifies the 3-way (4-way for "parameter", counting the long-vowel
variant) split rendering of "configuration file" and "configuration
parameter", consistent with the already-decided configuration item/
parameter/option compound direction (PR pingcap#23596).

512 occurrences/227 files, line-count-symmetric diff. Heading anchors
(English-derived) unchanged, only visible text updated. Out of scope,
left untouched: the standalone "configuration item" form and other
smaller compounds, and configuration-word usages in unrelated senses.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the fix-config-3rd-form branch from a1b8066 to 6c79299 Compare September 11, 2026 01:25
yahonda and others added 6 commits September 11, 2026 10:30
Expands the previous commit's scope to the rest of the corpus: item,
flag, option, guide, method, and other small compounds, plus bare
standalone use in headings, TOC labels, and prose.

193 occurrences/83 files. Two sites handled as manual exceptions
rather than a straight substitution:

- tidb-upgrade-migration-guide.md: a checklist bullet's label was
  itself the compound term, which would have produced a duplicated
  word if substituted literally; shortened to match sibling bullets'
  label style instead.
- tidb-cloud/csv-config-for-import-data.md: kept this file's own
  already-established term instead, since its H1/summary/title all
  independently agree on it and substituting here would have left
  the file self-contradictory rather than more consistent.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The Resource Manager page's Configuration/Estimate Capacity/Metrics
section names are literal TiDB Dashboard UI labels (verified against
pingcap/tidb-dashboard's own en.yaml translation file), not generic
prose to translate. The previous commit in this branch had converted
this file's Configuration bullet from a katakana rendering to
Japanese, which was the wrong direction for a UI-literal label;
Estimate Capacity and Metrics had similar pre-existing issues
unrelated to this branch. Fixes both headings, the section-list
bullets, one internal cross-reference link, and the frontmatter
summary that names all three sections.

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

"Required value" and "Why" were rendered as a literal compound noun
and a bare interrogative word, respectively, neither of which reads
naturally as a table header in Japanese. Changed to the standard
forms used elsewhere in the corpus for this kind of column.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- deploy-monitoring-services.md: the previous commit had converted
  this file's Configuration reference from katakana to Japanese, but
  it names a literal Grafana UI sidebar section ("Configuration"),
  verified against the EN source's own bolded literal English.
- dynamic-config.md: the dynamic TiKV config item table's first row
  showed the literal config key `log.level` translated into Japanese
  prose ("ログレベル"), unlike every other row in the same table
  (and the equivalent PD table elsewhere in this file), which
  correctly show the literal backtick-quoted key name.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
"Application" here means the deployment use case/scenario (column
values are OLTP, HTAP, TiCDC replication, etc.), but was translated
as the "applied skill/theory" sense of the word, which reads oddly
next to values like "OLTP" and "HTAP".

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

The bulk configuration-term substitution in an earlier commit
correctly converted the prefix but left one katakana synonym for
"item" untouched, missing that the corpus's established rendering
uses a different (kanji) word for "item" per the existing PR pingcap#23596
precedent. 4 sites/3 files.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@yahonda
yahonda force-pushed the fix-config-3rd-form branch from 2ba9d51 to 36f805c Compare September 11, 2026 02:29
@yahonda
yahonda marked this pull request as ready for review September 11, 2026 02:32
@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 11, 2026
@yahonda

yahonda commented Sep 11, 2026

Copy link
Copy Markdown
Member Author

Splitting this PR into two smaller PRs to stay under CodeRabbit's 150-file review limit (this PR grew to 265 files across 7 review-driven follow-up commits, 115 over the limit):

Both are byte-identical to this PR's final content for their respective file subsets. Closing in favor of the two split PRs.

@yahonda yahonda closed this Sep 11, 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. missing-translation-status This PR does not have translation status info. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant