Skip to content

i18n(ja): restore DM-master and DM-worker as literal English terms - #23635

Merged
qiancai merged 7 commits into
i18n-ja-release-8.5from
fix-dm-master-worker-term-english
Sep 7, 2026
Merged

i18n(ja): restore DM-master and DM-worker as literal English terms#23635
qiancai merged 7 commits into
i18n-ja-release-8.5from
fix-dm-master-worker-term-english

Conversation

@yahonda

@yahonda yahonda commented Aug 27, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

DM-master and DM-worker are the actual TiDB Data Migration (DM) tool component/binary names (matching the dm-master/dm-worker binaries and dm/master, dm/worker paths), not descriptive nouns that should be translated. This corpus rendered them inconsistently as katakana DMマスター/DMワーカー (and, found on a second pass, the space-separated variant DM マスター/DM ワーカー) in many places while other places already correctly kept them literal (DM-master/DM-worker).

This PR unifies all katakana occurrences (both spacing variants) to the literal English form, matching the direction already decided in a prior term-notation review.

  • DMマスター / DM マスターDM-master
  • DMワーカー / DM ワーカーDM-worker

101 files total, 465 sites (265 no-space + 200 space-separated, found on independent review of the first pass). Heading anchors ({#...}) were already stable English slugs, independent of the visible heading text, so none needed changing.

Generic uses of bare マスター/ワーカー (e.g. "master branch", other components) are unrelated to this term and were not touched — only the DM-prefixed forms were in scope.

Verified markdownlint-cli2 clean on all touched files.

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 DM terminology across reference, deployment, configuration, API, troubleshooting, and release documentation to use DM-master and DM-worker.
    • Updated table-of-contents entries, headings, labels, and cross-reference text while preserving existing links.
    • Added deployment recommendations for common DM-master and DM-worker scenarios.
    • Clarified secret-key file placement before running the encryption command.
    • Refined configuration parameter wording and unit descriptions for improved clarity.

@ti-chi-bot

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

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

This documentation-only change standardizes DM-master and DM-worker terminology across Japanese reference, deployment, operational, migration, TiUP, and release-note documents. It also updates selected deployment guidance and release-note entries.

Changes

DM documentation terminology

Layer / File(s) Summary
Reference and deployment terminology
TOC.md, api/*, best-practices-for-security-configuration.md, dm/*
Standardizes component names from Japanese transliterations to DM-master and DM-worker across reference, architecture, deployment, best-practice, command-line, and configuration content.
Configuration and operational guides
dm/*
Updates terminology in configuration, TLS, troubleshooting, FAQ, certificate, monitoring, and API guides. The worker configuration guide also revises unit and default-value wording.
Migration and maintenance guides
dm/*, migrate-*.md, tidb-cloud/migrate-sql-shards.md
Standardizes DM component names across migration, shard-merge, relay-log, monitoring, maintenance, quick-start, and usage guides.
Release and TiUP documentation
releases/*.md, tiup/*.md
Updates DM terminology in release notes and TiUP component and topology documentation. Several release-note entries are replaced or added with revised DM bug-fix content.

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

Merge Risk: 🔵 Low · up to f09e4

This change standardizes Japanese DM component names, but several inconsistent or ambiguous command and component references remain. They can confuse users following deployment or migration documentation, so the edits should be completed 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 main change: restoring the literal English component names DM-master and DM-worker in Japanese documentation.
Description check ✅ Passed The description explains the terminology changes, scope, affected documentation version, AI involvement, validation, and out-of-scope terms. Optional related links are left blank, but this does not ma…
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.
✨ 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-dm-master-worker-term-english

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 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 overvenus 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/XL Denotes a PR that changes 500-999 lines, ignoring generated files. 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
@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
@yahonda
yahonda force-pushed the fix-dm-master-worker-term-english branch from f2841cb to ba1acb0 Compare September 2, 2026 04:35
@yahonda
yahonda marked this pull request as ready for review September 2, 2026 04:40
@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
@yahonda
yahonda force-pushed the fix-dm-master-worker-term-english branch from ba1acb0 to ebd971e Compare September 3, 2026 02:09
DM-master and DM-worker are the actual TiDB Data Migration (DM) tool
component/binary names, matching the dm-master/dm-worker binaries and
dm/master, dm/worker paths — not descriptive nouns that should be
translated. Unifies the katakana renderings (DMマスター/DMワーカー)
to literal DM-master/DM-worker throughout, per the direction already
decided.

56 files, 265 sites.
The initial mechanical substitution only matched the no-space form
(DMマスター/DMワーカー) and missed the space-separated variant
(DM マスター/DM ワーカー), used in ~45 more files. Same fix, same
rationale: these are the actual TiDB Data Migration (DM) tool
component names, matching the dm-master/dm-worker binaries.

45 files, 200 sites.
@yahonda
yahonda force-pushed the fix-dm-master-worker-term-english branch from ebd971e to 79a030a Compare September 3, 2026 04:47
# Conflicts:
#	releases/release-5.3.1.md
#	releases/release-5.3.2.md
#	releases/release-5.4.1.md
#	releases/release-5.4.3.md
#	releases/release-6.0.0-dmr.md
#	releases/release-6.1.0.md
#	releases/release-6.1.1.md
#	releases/release-6.1.2.md
#	releases/release-6.1.3.md
#	releases/release-6.5.0.md
#	releases/release-6.5.12.md
#	releases/release-7.1.1.md
#	releases/release-7.1.6.md
#	releases/release-7.5.4.md
#	releases/release-8.1.2.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: 10

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
dm/usage-scenario-master-slave-switch.md (1)

32-32: 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Replace the remaining DM-work typos.

The file now uses DM-worker, but Lines 32 and 46 still say DM-work 接続. Replace both with DM-worker接続.

As per path instructions, this fix spans noncontiguous lines, so a regular review comment is appropriate.

Also applies to: 46-46

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 4df63325-4656-4a44-825f-8c6adc893b30

📥 Commits

Reviewing files that changed from the base of the PR and between 32de109 and 87f85ad.

📒 Files selected for processing (72)
  • TOC.md
  • api/_index.md
  • api/dm-api-overview.md
  • best-practices-for-security-configuration.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-arch.md
  • dm/dm-best-practices.md
  • dm/dm-command-line-flags.md
  • dm/dm-config-overview.md
  • dm/dm-customized-secret-key.md
  • dm/dm-daily-check.md
  • dm/dm-enable-tls.md
  • dm/dm-error-handling.md
  • dm/dm-faq.md
  • dm/dm-generate-self-signed-certificates.md
  • dm/dm-glossary.md
  • dm/dm-handle-alerts.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-open-api.md
  • dm/dm-performance-test.md
  • dm/dm-query-status.md
  • dm/dm-safe-mode.md
  • dm/dm-source-configuration-file.md
  • dm/dm-worker-configuration-file.md
  • dm/dm-worker-intro.md
  • dm/dmctl-introduction.md
  • dm/feature-shard-merge-optimistic.md
  • dm/feature-shard-merge-pessimistic.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/monitor-a-dm-cluster.md
  • dm/quick-start-create-task.md
  • dm/quick-start-with-dm.md
  • dm/relay-log.md
  • dm/shard-merge-best-practices.md
  • dm/task-configuration-file-full.md
  • dm/usage-scenario-master-slave-switch.md
  • migrate-large-mysql-shards-to-tidb.md
  • migrate-small-mysql-shards-to-tidb.md
  • migrate-small-mysql-to-tidb.md
  • migrate-with-more-columns-downstream.md
  • releases/release-5.3.1.md
  • releases/release-5.3.2.md
  • releases/release-5.4.0.md
  • releases/release-5.4.1.md
  • releases/release-5.4.3.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.1.md
  • releases/release-6.1.2.md
  • releases/release-6.1.3.md
  • releases/release-6.4.0.md
  • releases/release-6.5.0.md
  • releases/release-6.5.12.md
  • releases/release-7.0.0.md
  • releases/release-7.1.1.md
  • releases/release-7.1.6.md
  • releases/release-7.5.4.md
  • releases/release-8.1.2.md
  • releases/release-8.4.0.md
  • releases/release-8.5.0.md
  • tidb-cloud/migrate-sql-shards.md
  • tiup/tiup-component-dm-import.md
  • tiup/tiup-component-dm-template.md
  • tiup/tiup-dm-topology-reference.md

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

Comment thread dm/dm-best-practices.md
Comment thread dm/dm-config-overview.md Outdated
Comment thread dm/dm-customized-secret-key.md Outdated
Comment thread dm/manually-upgrade-dm-1.0-to-2.0.md Outdated
Comment thread dm/monitor-a-dm-cluster.md Outdated
Comment thread migrate-small-mysql-to-tidb.md Outdated
Comment thread migrate-with-more-columns-downstream.md
Comment thread releases/release-5.3.2.md Outdated
Comment thread releases/release-6.1.0.md Outdated
Comment thread tiup/tiup-component-dm-template.md Outdated

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


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 411e6458-f4a2-41ba-aeca-926de590b997

📥 Commits

Reviewing files that changed from the base of the PR and between 87f85ad and 46b2658.

📒 Files selected for processing (10)
  • dm/dm-config-overview.md
  • dm/dm-customized-secret-key.md
  • dm/manually-upgrade-dm-1.0-to-2.0.md
  • dm/monitor-a-dm-cluster.md
  • migrate-small-mysql-to-tidb.md
  • releases/release-5.3.2.md
  • releases/release-5.4.1.md
  • releases/release-6.1.0.md
  • tiup/tiup-component-dm-template.md
  • tiup/tiup-dm-topology-reference.md

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

Comment thread releases/release-5.3.2.md Outdated
Comment thread releases/release-7.1.1.md
- PDアドレスの完全な変更後、TiDBが`SHOW PUMP STATUS`または`SHOW DRAINER STATUS`経由でBinlogノードステータスを正しく照会できない問題を修正しました。 [#42643](https://github.com/pingcap/tidb/issues/42643) @[lichunzhu](https://github.com/lichunzhu)
- PD アドレスの完全な変更後に TiDB がバイナリログを書き込めなくなる問題を修正しました [#42643](https://github.com/pingcap/tidb/issues/42643) @[lance6716](https://github.com/lance6716)
- etcdクライアントが初期化中に最新のノード情報を自動的に同期しない問題を修正[#1236](https://github.com/pingcap/tidb-binlog/issues/1236) @[lichunzhu](https://github.com/lichunzhu)
- 移行対象のテーブル内の一意インデックスに空の列が含まれている場合にDM-masterが異常終了する問題を修正[#9247](https://github.com/pingcap/tiflow/issues/9247) @[lance6716](https://github.com/lance6716)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yahonda The lines after 138 need to be added back. PTAL. Thanks.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for catching this — confirmed and fixed. An earlier merge-conflict resolution in this branch's history had silently dropped large legitimate chunks of content (release notes added by sibling PRs already merged into the base) instead of properly combining both sides. I audited all files this PR touches and found the same silent-deletion pattern in 13 release-note files total (release-5.3.1/5.3.2/5.4.1/5.4.3/6.0.0-dmr/6.1.0/6.1.1/6.1.2/6.5.0/6.5.12/7.1.1/7.1.6/7.5.4.md). All 13 have been repaired by rebuilding each file from the current upstream/i18n-ja-release-8.5 base (which has the full correct content) and re-applying only this PR's own DM-master/DM-worker terminology fix on top -- verified every file's line count now matches upstream exactly, with only clean single-line diffs remaining. Sorry for the trouble, and thanks again for flagging it.

Comment thread releases/release-7.1.6.md
- 複数の DM-masterノードが同時にリーダーになり、データの不整合が発生する可能性がある問題を修正しました[#11602](https://github.com/pingcap/tiflow/issues/11602) @[GMHDBJD](https://github.com/GMHDBJD)
- `go-mysql` にアップグレードして接続ブロックの問題を修正しました [#11041](https://github.com/pingcap/tiflow/issues/11041) @[D3Hunter](https://github.com/D3Hunter)
- インデックスの長さがデフォルト値の`max-index-length` を超えるとデータレプリケーションが中断される問題を修正しました [#11459](https://github.com/pingcap/tiflow/issues/11459) @[michaelmdeng](https://github.com/michaelmdeng)
- LISTパーティションテーブルの`ALTER TABLE ... DROP PARTITION`文を複製するときにDMがエラーを返す問題を修正しました。 [#54760](https://github.com/pingcap/tidb/issues/54760) @[lance6716](https://github.com/lance6716)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here, some lines are deleted by mistake. Please check this change for all other release notes in this PR. Thanks. @yahonda

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same fix applies here -- see my reply on the release-7.1.1.md thread for the full explanation. This file's content has been restored to match upstream/i18n-ja-release-8.5 exactly, with only this PR's own DM-master/DM-worker terminology change remaining as a clean single-line diff.

# Conflicts:
#	releases/release-5.4.1.md
#	releases/release-6.0.0-dmr.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.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
releases/release-6.1.0.md (1)

430-430: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use the standardized DM-master spelling.

Line 430 still uses dm-master. Replace only the component name so this release note uses the same DM-master spelling as the other DM documentation.

        - 空の設定により DM-masterがpanicを起こす可能性がある問題を修正[`#3732`](https://github.com/pingcap/tiflow/issues/3732)

As per path instructions, this Markdown finding includes an exact GitHub committable replacement.

Source: Path instructions


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 22593bb9-d20e-492f-a1b3-6d6f6d4bf398

📥 Commits

Reviewing files that changed from the base of the PR and between 46b2658 and f09e4c6.

📒 Files selected for processing (15)
  • dm/monitor-a-dm-cluster.md
  • releases/release-5.3.1.md
  • releases/release-5.3.2.md
  • releases/release-5.4.0.md
  • releases/release-5.4.1.md
  • releases/release-5.4.3.md
  • releases/release-6.0.0-dmr.md
  • releases/release-6.1.0.md
  • releases/release-6.1.1.md
  • releases/release-6.1.2.md
  • releases/release-6.5.0.md
  • releases/release-6.5.12.md
  • releases/release-7.1.1.md
  • releases/release-7.1.6.md
  • releases/release-7.5.4.md

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

@ti-chi-bot ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label Sep 7, 2026
@ti-chi-bot

ti-chi-bot Bot commented Sep 7, 2026

Copy link
Copy Markdown

[LGTM Timeline notifier]

Timeline:

  • 2026-09-07 06:29:09.796229456 +0000 UTC m=+1692784.967323567: ☑️ agreed by qiancai.

@qiancai
qiancai merged commit 5d7b4a7 into i18n-ja-release-8.5 Sep 7, 2026
4 of 9 checks passed
@qiancai
qiancai deleted the fix-dm-master-worker-term-english branch September 7, 2026 06:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-1-more-lgtm Indicates a PR needs 1 more LGTM. 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