Skip to content

Fix Dumpling capitalization: product name should be capitalized#23042

Open
yahonda wants to merge 1 commit into
pingcap:release-8.5from
yahonda:topic/fix-dumpling-capitalization-release-8.5
Open

Fix Dumpling capitalization: product name should be capitalized#23042
yahonda wants to merge 1 commit into
pingcap:release-8.5from
yahonda:topic/fix-dumpling-capitalization-release-8.5

Conversation

@yahonda

@yahonda yahonda commented Jun 11, 2026

Copy link
Copy Markdown
Member

What is changed, added or deleted? (Required)

Changed lowercase 'dumpling' to 'Dumpling' when it refers to the product name (TiDB data export tool) rather than the command line. This prevents mistranslation of the product name as a common noun (e.g., '餃子' or '団子' in Japanese) during localization.

Command line references (e.g., tiup dumpling) remain unchanged.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v8.5 (TiDB 8.5 versions)
  • v8.4 (TiDB 8.4 versions)
  • v8.3 (TiDB 8.3 versions)
  • v8.2 (TiDB 8.2 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)
  • v6.1 (TiDB 6.1 versions)
  • v5.4 (TiDB 5.4 versions)
  • v5.3 (TiDB 5.3 versions)

What is the related PR or file link(s)?

  • This PR is translated from:
  • Other reference link(s):

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 commented Jun 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 kissmydb 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/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jun 11, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request capitalizes "dumpling" to "Dumpling" across several documentation files to ensure consistent terminology. The reviewer suggested additional improvements to align with the style guide, such as avoiding passive voice, correcting "TiDB-Lightning" to "TiDB Lightning", and simplifying phrasing to make instructions more direct.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread dm/dm-faq.md Outdated
You can avoid this issue in advance by configuring in the following ways:

1. Increase the value of `expire_logs_days` in the upstream MySQL database to avoid wrongly purging needed binlog files before the full migration task completes. If the data volume is large, it is recommended to use dumpling and TiDB-Lightning at the same time to speed up the task.
1. Increase the value of `expire_logs_days` in the upstream MySQL database to avoid wrongly purging needed binlog files before the full migration task completes. If the data volume is large, it is recommended to use Dumpling and TiDB-Lightning at the same time to speed up the task.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

low

The phrase "it is recommended to use" uses the passive voice. According to the style guide, we should avoid passive voice overuse and write in the second person ("you"). Additionally, "TiDB-Lightning" should be written as "TiDB Lightning" (without a hyphen) to maintain consistent terminology across the documentation.

Suggested change
1. Increase the value of `expire_logs_days` in the upstream MySQL database to avoid wrongly purging needed binlog files before the full migration task completes. If the data volume is large, it is recommended to use Dumpling and TiDB-Lightning at the same time to speed up the task.
1. Increase the value of `expire_logs_days` in the upstream MySQL database to avoid wrongly purging needed binlog files before the full migration task completes. If the data volume is large, we recommend that you use Dumpling and TiDB Lightning at the same time to speed up the task.
References
  1. Avoid passive voice overuse and use consistent terminology (e.g., 'TiDB Lightning' instead of 'TiDB-Lightning'). (link)

## Step 1: Prepare full backup data

First, you can use [dumpling](/dumpling-overview.md) to export data from MySQL.
First, you can use [Dumpling](/dumpling-overview.md) to export data from MySQL.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

low

The phrase "you can use" can be simplified to the direct imperative "use" to avoid unnecessary words and make the instruction more direct.

Suggested change
First, you can use [Dumpling](/dumpling-overview.md) to export data from MySQL.
First, use [Dumpling](/dumpling-overview.md) to export data from MySQL.
References
  1. Avoid unnecessary words and repetition. (link)

@yahonda yahonda force-pushed the topic/fix-dumpling-capitalization-release-8.5 branch from 3cdfb27 to a9dafee Compare June 11, 2026 07:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant