From 3a2c4e999ee91343b30a39b5a65159143442a83f Mon Sep 17 00:00:00 2001
From: easonn7 <93458949+easonn7@users.noreply.github.com>
Date: Tue, 5 Mar 2024 15:43:17 +0800
Subject: [PATCH 1/3] Update scale-tidb-using-tiup.md

---
 scale-tidb-using-tiup.md | 48 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 46 insertions(+), 2 deletions(-)

diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md
index f74bc725e6c9..d050df72320e 100644
--- a/scale-tidb-using-tiup.md
+++ b/scale-tidb-using-tiup.md
@@ -127,7 +127,29 @@ pd_servers:
 
 预期日志结尾输出 ```Scaled cluster `<cluster-name>` out successfully``` 信息，表示扩容操作成功。
 
-### 3. 检查集群状态
+### 3. 刷新集群配置
+
+> **注意：**
+>
+> 该操作仅在 PD 扩容时需要被执行。
+
+（1）更新集群配置：
+
+  {{< copyable "shell-regular" >}}
+
+  ```shell
+  tiup cluster reload <cluster-name> --skip-restart
+  ```
+
+（2）更新 Prometheus 配置并重启：
+
+  {{< copyable "shell-regular" >}}
+
+  ```shell
+  tiup cluster reload <cluster-name> -R prometheus
+  ```
+
+### 4. 检查集群状态
 
 {{< copyable "shell-regular" >}}
 
@@ -326,7 +348,29 @@ tiup cluster scale-in <cluster-name> --node 10.0.1.5:20160
 
 预期输出 Scaled cluster `<cluster-name>` in successfully 信息，表示缩容操作成功。
 
-### 3. 检查集群状态
+### 3. 刷新集群配置
+
+> **注意：**
+>
+> 该操作仅在 PD 缩容时需要被执行。
+
+（1）更新集群配置：
+
+  {{< copyable "shell-regular" >}}
+
+  ```shell
+  tiup cluster reload <cluster-name> --skip-restart
+  ```
+
+（2）更新 Prometheus 配置并重启：
+
+  {{< copyable "shell-regular" >}}
+
+  ```shell
+  tiup cluster reload <cluster-name> -R prometheus
+  ```
+
+### 4. 检查集群状态
 
 下线需要一定时间，下线节点的状态变为 Tombstone 就说明下线成功。
 

From 597ee8d24ee6b0228864b070496862d331e71013 Mon Sep 17 00:00:00 2001
From: Lilian Lee <lilin@pingcap.com>
Date: Tue, 16 Apr 2024 16:45:26 +0800
Subject: [PATCH 2/3] Make wording and steps clear

---
 scale-tidb-using-tiup.md | 52 ++++++++++++++++++++--------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md
index d050df72320e..c6ca7bc54bf2 100644
--- a/scale-tidb-using-tiup.md
+++ b/scale-tidb-using-tiup.md
@@ -131,25 +131,25 @@ pd_servers:
 
 > **注意：**
 >
-> 该操作仅在 PD 扩容时需要被执行。
+> 该操作仅需在扩容 PD 节点时执行，扩容 TiDB 或 TiKV 节点时无需执行。
 
-（1）更新集群配置：
+1. 更新集群配置：
 
-  {{< copyable "shell-regular" >}}
+    ```shell
+    tiup cluster reload <cluster-name> --skip-restart
+    ```
 
-  ```shell
-  tiup cluster reload <cluster-name> --skip-restart
-  ```
+2. 更新 Prometheus 配置并重启：
 
-（2）更新 Prometheus 配置并重启：
+    > **注意：**
+    >
+    > 如果你使用的 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
 
-  {{< copyable "shell-regular" >}}
-
-  ```shell
-  tiup cluster reload <cluster-name> -R prometheus
-  ```
+    ```shell
+    tiup cluster reload <cluster-name> -R prometheus
+    ```
 
-### 4. 检查集群状态
+### 4. 查看集群状态
 
 {{< copyable "shell-regular" >}}
 
@@ -352,25 +352,25 @@ tiup cluster scale-in <cluster-name> --node 10.0.1.5:20160
 
 > **注意：**
 >
-> 该操作仅在 PD 缩容时需要被执行。
+> 该操作仅需在缩容 PD 节点时执行，缩容 TiDB 或 TiKV 节点时无需执行。
 
-（1）更新集群配置：
+1. 更新集群配置：
 
-  {{< copyable "shell-regular" >}}
+    ```shell
+    tiup cluster reload <cluster-name> --skip-restart
+    ```
 
-  ```shell
-  tiup cluster reload <cluster-name> --skip-restart
-  ```
+2. 更新 Prometheus 配置并重启：
 
-（2）更新 Prometheus 配置并重启：
+    > **注意：**
+    >
+    > 如果你使用的 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
 
-  {{< copyable "shell-regular" >}}
-
-  ```shell
-  tiup cluster reload <cluster-name> -R prometheus
-  ```
+    ```shell
+    tiup cluster reload <cluster-name> -R prometheus
+    ```
 
-### 4. 检查集群状态
+### 4. 查看集群状态
 
 下线需要一定时间，下线节点的状态变为 Tombstone 就说明下线成功。
 

From 7b13e73899bd29c509e7a549d303c68745c9d376 Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Tue, 16 Apr 2024 16:55:40 +0800
Subject: [PATCH 3/3] wording updates

---
 scale-tidb-using-tiup.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md
index c6ca7bc54bf2..24f7c690a41f 100644
--- a/scale-tidb-using-tiup.md
+++ b/scale-tidb-using-tiup.md
@@ -143,7 +143,7 @@ pd_servers:
 
     > **注意：**
     >
-    > 如果你使用的 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
+    > 如果你使用的是 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
 
     ```shell
     tiup cluster reload <cluster-name> -R prometheus
@@ -364,7 +364,7 @@ tiup cluster scale-in <cluster-name> --node 10.0.1.5:20160
 
     > **注意：**
     >
-    > 如果你使用的 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
+    > 如果你使用的是 TiUP v1.15.0 及之后版本，请跳过此步骤；如果你使用的 TiUP 版本早于 v1.15.0，则需要执行以下命令来更新 Prometheus 配置并重启。
 
     ```shell
     tiup cluster reload <cluster-name> -R prometheus