diff --git a/docs/en/12-taos-sql/06-select.md b/docs/en/12-taos-sql/06-select.md
index f1e19a5449..2606b183b8 100755
--- a/docs/en/12-taos-sql/06-select.md
+++ b/docs/en/12-taos-sql/06-select.md
@@ -259,7 +259,11 @@ The GROUP BY clause does not guarantee that the results are ordered. If you want
 
 ## PARTITION BY
 
-The PARTITION BY clause is a TDengine-specific extension to standard SQL. This clause partitions data based on the part_list and performs computations per partition.
+The PARTITION BY clause is a TDengine-specific extension to standard SQL introduced in TDengine 3.0. This clause partitions data based on the part_list and performs computations per partition.
+
+PARTITION BY and GROUP BY have similar meanings. They both group data according to a specified list and then perform calculations. The difference is that PARTITION BY does not have various restrictions on the SELECT list of the GROUP BY clause. Any operation can be performed within the group (constants, aggregations, scalars, expressions, etc.). Therefore, PARTITION BY is fully compatible with GROUP BY in terms of usage. All places that use the GROUP BY clause can be replaced with PARTITION BY.
+
+Because PARTITION BY does not require returning a row of aggregated data, it can also support various window operations after grouping slices. All window operations that need to be grouped can only use the PARTITION BY clause.
 
 For more information, see TDengine Extensions.
 
diff --git a/docs/en/12-taos-sql/12-distinguished.md b/docs/en/12-taos-sql/12-distinguished.md
index 502b7562f3..64687de9f3 100644
--- a/docs/en/12-taos-sql/12-distinguished.md
+++ b/docs/en/12-taos-sql/12-distinguished.md
@@ -16,7 +16,10 @@ When you query a supertable, you may need to partition the supertable by some di
 PARTITION BY part_list
 ```
 
-part_list can be any scalar expression, such as a column, constant, scalar function, or a combination of the preceding items.
+part_list can be any scalar expression, such as a column, constant, scalar function, or a combination of the preceding items. For example, grouping data by label location, taking the average voltage within each group.
+```sql
+select avg(voltage) from meters partition by location
+```
 
 A PARTITION BY clause is processed as follows:
 
@@ -28,7 +31,10 @@ A PARTITION BY clause is processed as follows:
 select max(current) from meters partition by location interval(10m)
 ```
 
-The most common usage of PARTITION BY is partitioning the data in subtables by tags then perform computation when querying data in a supertable. More specifically, `PARTITION BY TBNAME` partitions the data of each subtable into a single timeline, and this method facilitates the statistical analysis in many use cases of processing timeseries data.
+The most common usage of PARTITION BY is partitioning the data in subtables by tags then perform computation when querying data in a supertable. More specifically, `PARTITION BY TBNAME` partitions the data of each subtable into a single timeline, and this method facilitates the statistical analysis in many use cases of processing timeseries data. For example, calculate the average voltage of each meter every 10 minutes£º
+```sql
+select avg(voltage) from meters partition by tbname interval(10m)
+```
 
 ## Windowed Queries
 
diff --git a/docs/zh/12-taos-sql/06-select.md b/docs/zh/12-taos-sql/06-select.md
index 04508ceede..23ae025610 100755
--- a/docs/zh/12-taos-sql/06-select.md
+++ b/docs/zh/12-taos-sql/06-select.md
@@ -259,7 +259,12 @@ GROUP BY ��中的表达��以包�表或视图中的任何列，这些
 
 ## PARTITION BY
 
-PARTITION BY ��是 TDengine 特色语法，按 part_list 对数�进行切分，在�个切分的分片中进行计算。
+PARTITION BY ��是 TDengine 3.0版本引入的特色语法，用于根� part_list 对数�进行切分，在�个切分的分片中�以进行��计算。
+
+PARTITION BY 与 GROUP BY 基本�义相似，都是按照指定列表进行数�分组然�进行计算，��点在于 PARTITION BY 没有 GROUP BY ��的 SELECT 列表的���制，组内�以进行任��算（常�����标��表达�等），因此在使用上 PARTITION BY 完全兼容 GROUP BY，所有使用 GROUP BY ��的地方都�以替�为 PARTITION BY。
+
+因为 PARTITION BY 没有返回一行��数�的�求，因此还�以支�在分组切片�的��窗��算，所有需�分组进行的窗��算都�能使用 PARTITION BY ��。
+
 
 详� [TDengine 特色查询](../distinguished)
 
diff --git a/docs/zh/12-taos-sql/12-distinguished.md b/docs/zh/12-taos-sql/12-distinguished.md
index 98bfd3567a..a9fa1b6bb1 100755
--- a/docs/zh/12-taos-sql/12-distinguished.md
+++ b/docs/zh/12-taos-sql/12-distinguished.md
@@ -16,7 +16,11 @@ TDengine �供的特色查询包括数�切分查询和时间窗�切分查
 PARTITION BY part_list
 ```
 
-part_list �以是任�的标�表达�，包括列�常��标�函数和它们的组�。
+part_list �以是任�的标�表达�，包括列�常��标�函数和它们的组�。例如，将数�按标签 location 进行分组，��个分组内的电压平�值：
+```sql
+select avg(voltage) from meters partition by location
+```
+
 
 TDengine 按如下方�处�数�切分��：
 
@@ -27,7 +31,11 @@ TDengine 按如下方�处�数�切分��：
 ```sql
 select max(current) from meters partition by location interval(10m)
 ```
-数�切分��最常�的用法就是在超级表查询中，按标签将�表数�进行切分，然�分别进行计算。特别是 PARTITION BY TBNAME 用法，它将�个�表的数�独立出�，形�一��独立的时间�列，�大的方便了��时�场景的统计分�。
+数�切分��最常�的用法就是在超级表查询中，按标签将�表数�进行切分，然�分别进行计算。特别是 PARTITION BY TBNAME 用法，它将�个�表的数�独立出�，形�一��独立的时间�列，�大的方便了��时�场景的统计分�。例如，统计�个电表� 10 分钟内的电压平�值：
+```sql
+select avg(voltage) from meters partition by tbname interval(10m)
+```
+
 
 ## 窗�切分查询