Skip to content

Commit 2d83322

Browse files
authored
pr_template: Provides tips for cherry-pick (#6702) (#6725)
1 parent c9dd5a1 commit 2d83322

File tree

2 files changed

+24
-1
lines changed

2 files changed

+24
-1
lines changed

.github/pull_request_template.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,12 @@
1212

1313
<!-- Fill in "x" in [] to tick the checkbox below.-->
1414

15+
**Tips for choosing the affected version(s):**
16+
17+
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**.
18+
19+
For details, see [tips for choosing the affected versions (in Chinese)](/CONTRIBUTING.md#版本选择指南).
20+
1521
- [ ] master (the latest development version)
1622
- [ ] v5.1 (TiDB 5.1 versions)
1723
- [ ] v5.0 (TiDB 5.0 versions)

CONTRIBUTING.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ TiDB 文档的修改需要遵循一定的流程,具体如下。考虑到有些
9191

9292
> **注意:**
9393
>
94-
> 目前 TiDB 主要维护以下几个版本的文档:dev(最新开发版)、v5.0、v4.0、v3.1、v3.0 以及 v2.1。提 Pull Request 前请务必考虑修改会影响的文档版本,并据此修改所有相应的版本。
94+
> 目前 TiDB 主要维护以下几个版本的文档:dev(最新开发版,对应文档仓库的 master 分支)、v5.1、v5.0、v4.0、v3.1、v3.0 以及 v2.1。提 Pull Request 前请务必考虑修改会影响的文档版本,并据此修改所有相应的版本。选择版本时,请参考[版本选择指南](#版本选择指南)
9595
9696
### 第 0 步:签署 Contributor License Agreement
9797

@@ -194,6 +194,23 @@ TiDB 中文文档使用 Markdown 语言进行编写,为了保证文档质量
194194
| `/cc` | 将 PR 分配给指定的 reviewer,需 @指定用户的 GitHub ID,多个 GitHub ID 间用逗号分隔。 | `/cc @TomShawn, @yikeke` |
195195
| `/uncc` | 移除 PR 之前指定的 reviewer。 | `/uncc @TomShawn`|
196196

197+
## 版本选择指南
198+
199+
创建 Pull Request 时,你需要在 Pull Request 的描述模版中选择文档改动适用的版本分支。
200+
201+
如果你的 PR 改动符合以下任一情况,推荐**只选择 master 分支**。此 PR 的改动在合并后将显示到[官网文档 Dev 页面](https://docs.pingcap.com/zh/tidb/dev/),在下一次 TiDB 发新版本时将显示到对应版本的文档页面。
202+
203+
- 完善和优化文档内容,例如补充缺失或不完整的信息。
204+
- 修正不准确或错误的文档内容,例如默认值错误、描述不准确、示例错误、拼写错误等。
205+
- 重新组织现有文档的某个局部,例如“部署标准集群”、“数据迁移”、“TiDB 生态工具”等。
206+
207+
如果你的 PR 改动符合以下任一情况,请**选择 master 分支以及受影响的 release 分支**
208+
209+
- 涉及与版本相关的功能行为变化。
210+
- 涉及与版本相关的兼容性变化,例如更改某个配置项或变量的默认值。
211+
- 修复文档页面的渲染或显示错误。
212+
- 修复文档内的死链。
213+
197214
## 联系我们
198215

199216
加入 Slack channel:[#sig-docs](https://slack.tidb.io/invite?team=tidb-community&channel=sig-docs&ref=pingcap-docs-cn)

0 commit comments

Comments
 (0)