Skip to content

Fix duplicated "的" typos in Chinese docs (#21985) - #21987

Open
ti-chi-bot wants to merge 1 commit into
pingcap:release-8.5from
ti-chi-bot:cherry-pick-21985-to-release-8.5
Open

ti-chi-bot wants to merge 1 commit into
pingcap:release-8.5from
ti-chi-bot:cherry-pick-21985-to-release-8.5

Conversation

@ti-chi-bot

@ti-chi-bot ti-chi-bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

This is an automated cherry-pick of #21985

First-time contributors' checklist

What is changed, added, or deleted?

Fix duplicated "的" typos in 15 places across 14 Chinese doc files. Only the duplicated character is removed; no semantic changes.

Examples:

  • 提高 Raft 通信的的最大连接数 → 提高 Raft 通信的最大连接数
  • 按照以上推荐的的方式进行备份 → 按照以上推荐的方式进行备份
  • 在 TiDB Cloud 上的的第一个 SQL → 在 TiDB Cloud 上的第一个 SQL
  • URI 中可配置的的参数如下 → URI 中可配置的参数如下

Note: glossary.md is intentionally left unchanged because "调度目的的一系列操作" there is a valid "目的" + "的", not a typo.

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

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 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)
  • v5.2 (TiDB 5.2 versions)
  • v5.1 (TiDB 5.1 versions)

Summary by CodeRabbit

  • 文档
    • 修正多处中文文档中的重复用词和文字笔误,提升内容可读性。
    • 新增时区配置文档的两个访问别名。
    • 保持示例、查询逻辑、配置含义、默认值及调优行为不变。

Signed-off-by: ti-chi-bot <ti-community-prow-bot@tidb.io>
@ti-chi-bot ti-chi-bot added area/develop This PR relates to the area of TiDB App development. contribution This PR is from a community contributor. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. first-time-contributor Indicates that the PR was contributed by an external member and is a first-time contributor. lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. type/cherry-pick-for-release-8.5 This PR is cherry-picked to release-8.5 from a source PR. labels Oct 20, 2026
@ti-chi-bot

ti-chi-bot Bot commented Oct 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 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

@coderabbitai

coderabbitai Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

📝 Walkthrough

本次修改修正多处中文文档中的重复用字,并修订时区文档摘要。时区文档还新增两个别名路径。配置含义、SQL 示例及其他文档行为未变。

Changes: 文档修订

Layer / File(s) Summary
文字修订与时区文档别名
configure-time-zone.md, best-practices/massive-regions-best-practices.md, br/br-use-overview.md, develop/dev-guide-*.md, releases/release-3.0.0-rc.1.md, sql-plan-management.md, ticdc/ticdc-sink-to-*.md, tidb-lightning/tidb-lightning-logical-import-mode-usage.md, tikv-configuration-file.md
多处文档修正重复用字。时区文档摘要修订,并新增 /docs-cn/dev/configure-time-zone/ 和 /docs-cn/dev/how-to/configure/time-zone/ 两个别名。

Priority: ⬇️ Low

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

Change: Other

Suggested reviewers: qiancai

Merge Risk: 🟡 Moderate · up to 1698f

Most of this change is safe typo cleanup, but the time-zone page still has unresolved merge-conflict markers in its page metadata. That can break the documentation build or show conflict text on the published page. Resolve the conflict before merging.

Architecture Summary

Architecture risk: 🔵 Low · up to 1698f

The change affects 9 systems.

Changed systems: develop, ticdc, best-practices, br, configure-time-zone.md, releases, sql-plan-management.md, tidb-lightning, tikv-configuration-file.md

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — develop (service) was modified; 5 changed files map to changed impact.
  • observed — ticdc (service) was modified; 2 changed files map to changed impact.
  • observed — best-practices (service) was modified; 1 changed file maps to changed impact.
  • observed — br (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in best-practices/massive-regions-best-practices.md: 修正方法七标题中的文字错误,将“的的”改为“的”。
  • observed — Modified behavior in br/br-use-overview.md: 修正恢复到备份保留期内任意时间点的说明中的重复“的”。
  • observed — Modified behavior in br/br-use-overview.md: 修正网络带宽要求说明中的重复“的”。
  • observed — Modified behavior in configure-time-zone.md: 修复摘要中 TIMESTAMP 后的重复“的”字,并新增两个文档 aliases 路径。
Pre-merge checks: Passed 4 · Failed 1

Failed Failed checks: 1 warning

Check name Status Explanation Resolution
Description check Warning 描述说明了修改范围、示例和无语义变更,但版本选择与 PR 目标不一致。PR 目标为 release-8.5 分支,描述却勾选了 master;同时缺少模板中的相关链接、AI agent involvement 和变更类型检查项。 将版本选择改为与目标分支一致的 v8.5,并补充或明确模板中缺失的相关链接、AI agent involvement 和变更类型检查项。
Passed Passed checks: 4 passed
Check name Status Explanation
Title check Passed 标题准确概括了主要变更,即修复中文文档中的重复“的”字错误,并标明了相关 PR。
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: 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. (14 skipped: 14 unsupported.)

  • Fix all pre-merge checks with AI
✨ Finishing Touches: 💡 1
🛠️ Fix failing CI checks: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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 Oct 20, 2026

Copy link
Copy Markdown

@ti-chi-bot: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
pull-verify 1698f6d link true /test pull-verify

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@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

🔇 Additional comments: 13
best-practices/massive-regions-best-practices.md: 1

147-147: LGTM!

br/br-use-overview.md: 1

61-61: LGTM!

Also applies to: 67-67

develop/dev-guide-build-cluster-in-cloud.md: 1

127-127: LGTM!

develop/dev-guide-connection-parameters.md: 1

106-106: LGTM!

develop/dev-guide-proxysql-integration.md: 1

131-131: LGTM!

develop/dev-guide-use-subqueries.md: 1

91-91: LGTM!

releases/release-3.0.0-rc.1.md: 1

25-25: LGTM!

sql-plan-management.md: 1

340-340: LGTM!

ticdc/ticdc-sink-to-kafka.md: 1

69-69: LGTM!

ticdc/ticdc-sink-to-pulsar.md: 1

62-62: LGTM!

tidb-lightning/tidb-lightning-logical-import-mode-usage.md: 1

67-67: LGTM!

tikv-configuration-file.md: 1

822-822: LGTM!

develop/dev-guide-create-secondary-indexes.md-132-132: 1

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

⚠️ Unverified finding
Verification ran but could not confirm this finding. It is shown for review, not as a verified issue.

修改句子,避免不自然的表达。

当前句子中的“对……的解读及算子等不做进一步的展开”和“查看更多关于……”表达不够直接。语言检查也标记了该行。请使用更简洁的句子。

可直接替换的文案
-上方执行计划中的 **TableFullScan**、**IndexRangeScan** 等在 TiDB 内被称为[算子](/explain-overview.md#算子简介)。这里对执行计划的解读及算子等不做进一步的展开,若你对此感兴趣,可前往 [TiDB 执行计划概览](/explain-overview.md)文档查看更多关于执行计划与 TiDB 算子的相关知识。
+上方执行计划中的 **TableFullScan**、**IndexRangeScan** 等在 TiDB 内被称为[算子](/explain-overview.md#算子简介)。这里不再进一步介绍执行计划和算子。如需了解更多信息,请参阅 [TiDB 执行计划概览](/explain-overview.md)文档。

依据 Markdown 文档审阅规则:可安全替换连续行时必须提供精确的可提交替换建议。

Sources: Path instructions, Linters/SAST tools


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Repository: pingcap/docs-cn/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: a0b544b0-6263-48e2-a6c7-807f20adff6a
📥 Commits

Reviewing files that changed from the base of the PR and between 9c59f34 and 1698f6d.

📒 Files selected for processing: 14
  • best-practices/massive-regions-best-practices.md
  • br/br-use-overview.md
  • configure-time-zone.md
  • develop/dev-guide-build-cluster-in-cloud.md
  • develop/dev-guide-connection-parameters.md
  • develop/dev-guide-create-secondary-indexes.md
  • develop/dev-guide-proxysql-integration.md
  • develop/dev-guide-use-subqueries.md
  • releases/release-3.0.0-rc.1.md
  • sql-plan-management.md
  • ticdc/ticdc-sink-to-kafka.md
  • ticdc/ticdc-sink-to-pulsar.md
  • tidb-lightning/tidb-lightning-logical-import-mode-usage.md
  • tikv-configuration-file.md

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

Comment thread configure-time-zone.md
Comment on lines +3 to +8
<<<<<<< HEAD
summary: TiDB 的时区设置由 `time_zone` 系统变量控制,可以在会话级别或全局级别进行设置。`TIMESTAMP` 数据类型的的显示值受时区设置影响,但 `DATETIME`、`DATE` 或 `TIME` 数据类型不受影响。在数据迁移时,需要特别注意主库和从库的时区设置是否一致。
=======
aliases: ['/docs-cn/dev/configure-time-zone/','/docs-cn/dev/how-to/configure/time-zone/']
summary: TiDB 的时区设置由 `time_zone` 系统变量控制,可以在会话级别或全局级别进行设置。`TIMESTAMP` 数据类型的显示值受时区设置影响,但 `DATETIME`、`DATE` 或 `TIME` 数据类型不受影响。在数据迁移时,需要特别注意主库和从库的时区设置是否一致。
>>>>>>> 8860d46818 (Fix duplicated "的" typos in Chinese docs (#21985))

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

先解决未完成的 Git 合并冲突。

当前 front matter 保留了冲突标记,并包含两个不同的 summary。静态站点构建无法可靠解析该 YAML 元数据。请保留修正后的 summary,并合并新增的 aliases。

可直接替换的 front matter
-&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD
-summary: TiDB 的时区设置由 `time_zone` 系统变量控制,可以在会话级别或全局级别进行设置。`TIMESTAMP` 数据类型的的显示值受时区设置影响,但 `DATETIME`、`DATE` 或 `TIME` 数据类型不受影响。在数据迁移时,需要特别注意主库和从库的时区设置是否一致。
-=======
 aliases: ['/docs-cn/dev/configure-time-zone/','/docs-cn/dev/how-to/configure/time-zone/']
 summary: TiDB 的时区设置由 `time_zone` 系统变量控制,可以在会话级别或全局级别进行设置。`TIMESTAMP` 数据类型的显示值受时区设置影响,但 `DATETIME`、`DATE` 或 `TIME` 数据类型不受影响。在数据迁移时,需要特别注意主库和从库的时区设置是否一致。
-&gt;&gt;&gt;&gt;&gt;&gt;&gt; 8860d46818 (Fix duplicated "的" typos in Chinese docs (#21985))

依据 Markdown 文档审阅规则:可安全替换连续行时必须提供精确的可提交替换建议。

Source: Path instructions

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. contribution This PR is from a community contributor. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. first-time-contributor Indicates that the PR was contributed by an external member and is a first-time contributor. lgtm needs-1-more-lgtm Indicates a PR needs 1 more LGTM. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. type/cherry-pick-for-release-8.5 This PR is cherry-picked to release-8.5 from a source PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants