From 312c7257a8a951c44107f561264a67e3f1103b14 Mon Sep 17 00:00:00 2001
From: enkilee <jeffrey0122@163.com>
Date: Thu, 15 Sep 2022 04:37:30 +0000
Subject: [PATCH 01/31] fix chinese docs errors

---
 docs/api/paddle/nn/functional/glu_cn.rst         | 4 ++--
 docs/api/paddle/nn/functional/grid_sample_cn.rst | 6 +++---
 docs/api/paddle/nn/functional/log_loss_cn.rst    | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/api/paddle/nn/functional/glu_cn.rst b/docs/api/paddle/nn/functional/glu_cn.rst
index 10f7de9099f..dd9262b5263 100644
--- a/docs/api/paddle/nn/functional/glu_cn.rst
+++ b/docs/api/paddle/nn/functional/glu_cn.rst
@@ -15,8 +15,8 @@ glu
 ::::::::::::
 
 ::::::::::
- - x (Tensor) - 输入的 ``Tensor``，数据类型为：float32、float64。
- - axis (int，可选) - 沿着该轴将输入二等分。D 为输入的维数，则 ``axis`` 应该在 [-D, D) 的范围内。如 ``axis`` 为负数，则相当于 ``axis +D``。
+ - **x** (Tensor) - 输入的 ``Tensor``，数据类型为：float32、float64。
+ - **axis** (int，可选) - 沿着该轴将输入二等分。D 为输入的维数，则 ``axis`` 应该在 [-D, D) 的范围内。如 ``axis`` 为负数，则相当于 ``axis +D``。
  - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
diff --git a/docs/api/paddle/nn/functional/grid_sample_cn.rst b/docs/api/paddle/nn/functional/grid_sample_cn.rst
index 3391dd03675..a4e2aac7767 100644
--- a/docs/api/paddle/nn/functional/grid_sample_cn.rst
+++ b/docs/api/paddle/nn/functional/grid_sample_cn.rst
@@ -19,7 +19,8 @@ step 1：
 
 .. code-block:: text
 
-  grid_x = 0.5 * (grid[:, :, :, 0] + 1) * (W - 1) grid_y = 0.5 * (grid[:, :, :, 1] + 1) * (H - 1)
+  grid_x = 0.5 * (grid[:, :, :, 0] + 1) * (W - 1)
+  grid_y = 0.5 * (grid[:, :, :, 1] + 1) * (H - 1)
 
 step 2：
 
@@ -66,8 +67,7 @@ step 2：
 
 返回
 ::::::::::::
-Tensor，输入 X 基于输入网格的双线性插值计算结果，维度为 :math:`[N, C, H, W]` 的 4-D Tensor 或维度为 :math:`[N, C, D, H, W]` 的 5-D Tensor，
-数据类型与 ``x`` 一致。
+Tensor，输入 X 基于输入网格的双线性插值计算结果，维度为 :math:`[N, C, H, W]` 的 4-D Tensor 或维度为 :math:`[N, C, D, H, W]` 的 5-D Tensor， grid_H 是 grid 的特征高度， grid_W 是 grid 的特征深度，数据类型与 ``x`` 一致。
 
 
 代码示例
diff --git a/docs/api/paddle/nn/functional/log_loss_cn.rst b/docs/api/paddle/nn/functional/log_loss_cn.rst
index 464e268bcc9..7655477e3f5 100644
--- a/docs/api/paddle/nn/functional/log_loss_cn.rst
+++ b/docs/api/paddle/nn/functional/log_loss_cn.rst
@@ -22,7 +22,7 @@ log_loss
 
   - **input** (Tensor) – 形为 [N x 1] 的二维张量，其中 N 为 batch 大小。该输入是由前驱算子计算得来的概率，数据类型是 float32。
   - **label** (Tensor) – 形为 [N x 1] 的二维张量，真值标签，其中 N 为 batch 大小，数据类型是 float32。
-  - **epsilon** (float) – epsilon
+  - **epsilon** (float) – 一个很小的数字，以保证数值的稳定性，默认值为 1e-4。
   - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

From 11dc538537d562460896ddd545fa8f9b671eb33f Mon Sep 17 00:00:00 2001
From: enkilee <jeffrey0122@163.com>
Date: Thu, 15 Sep 2022 06:07:21 +0000
Subject: [PATCH 02/31] fix chinese docs errors

---
 docs/api/paddle/distribution/IndependentTransform_cn.rst | 9 ++++-----
 docs/api/paddle/distribution/Multinomial_cn.rst          | 5 ++---
 docs/api/paddle/distribution/Normal_cn.rst               | 5 +++++
 docs/api/paddle/distribution/PowerTransform_cn.rst       | 4 +++-
 docs/api/paddle/distribution/ReshapeTransform_cn.rst     | 2 +-
 docs/api/paddle/distribution/SigmoidTransform_cn.rst     | 2 +-
 docs/api/paddle/distribution/SoftmaxTransform_cn.rst     | 2 +-
 docs/api/paddle/distribution/StackTransform_cn.rst       | 2 +-
 8 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/docs/api/paddle/distribution/IndependentTransform_cn.rst b/docs/api/paddle/distribution/IndependentTransform_cn.rst
index 678f7a5a1f6..71cf8e946ed 100644
--- a/docs/api/paddle/distribution/IndependentTransform_cn.rst
+++ b/docs/api/paddle/distribution/IndependentTransform_cn.rst
@@ -12,19 +12,18 @@ IndependentTransform
  ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 计算结果沿着扩展的维度进行求和。
 
 例如，假设基础变换为 ``ExpTransform``，其输入为一个随机采样结果 ``x``，形状
-为 ``(S=[4],B=[2,2],E=[3])`` , ``S`` 、``B`` 、``E`` 分别表示采样形状、批形状、事件形
-状，``reinterpreted_batch_rank=1``。则 ``IndependentTransform(ExpTransform)``
+为 ``(S=[4],B=[2,2],E=[3])`` , ``S`` 、``B`` 、``E`` 分别表示采样形状、批形状、事件形状，
+``reinterpreted_batch_rank=1``。则 ``IndependentTransform(ExpTransform)``
 变换后，``x`` 的形状为 ``(S=[4],B=[2],E=[2,3])``，即将最右侧的批维度作为事件维度。
 此时 ``forward`` 和 ``inverse`` 输出形状仍是 ``(4,2,2,3)`` ,
-但 ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 输出形状
-为 ``(4, 2)`` 。
+但 ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 输出形状为 ``(4, 2)`` 。
 
 
 参数
 :::::::::
 
 - **base** (Transform) - 基础变换。
-- **reinterpreted_batch_rank** (int) - 被扩展为事件维度的最右侧批维度数量。
+- **reinterpreted_batch_rank** (int) - 被扩展为事件维度的最右侧批维度数量，需大于 0。
 
 
 代码示例
diff --git a/docs/api/paddle/distribution/Multinomial_cn.rst b/docs/api/paddle/distribution/Multinomial_cn.rst
index b10ada143be..78e27752d83 100644
--- a/docs/api/paddle/distribution/Multinomial_cn.rst
+++ b/docs/api/paddle/distribution/Multinomial_cn.rst
@@ -18,8 +18,7 @@ Multinomial
 
 
 其中，:math:`n` 表示实验次数，:math:`k` 表示类别数，:math:`p_i` 表示一次实验中，实验结果
-为第 :math:`i` 个类别的概率，需要满足 :math:`{\textstyle \sum_{i=1}^{k}p_i=1}, p_i \ge 0` ,
- :math:`x_i` 表示第 :math:`i` 个分类出现的次数。
+为第 :math:`i` 个类别的概率，需要满足 :math:`{\textstyle \sum_{i=1}^{k}p_i=1}, p_i \ge 0` , :math:`x_i` 表示第 :math:`i` 个分类出现的次数。
 
 
 
@@ -27,7 +26,7 @@ Multinomial
 :::::::::
 
 - **total_count** (int) - 实验次数。
-- **probs** (Tensor） - 每个类别发生的概率。最后一维为事件维度，其它维为批维度。``probs`` 中
+- **probs** （Tensor） - 每个类别发生的概率。最后一维为事件维度，其它维为批维度。``probs`` 中
   的每个元素取值范围为 ``[0,1]``。如果输入数据大于 1，会沿着最后一维进行归一化操作。
 
 代码示例
diff --git a/docs/api/paddle/distribution/Normal_cn.rst b/docs/api/paddle/distribution/Normal_cn.rst
index 1b9ff348354..b98fe6ac8ca 100644
--- a/docs/api/paddle/distribution/Normal_cn.rst
+++ b/docs/api/paddle/distribution/Normal_cn.rst
@@ -117,10 +117,15 @@ kl_divergence(other)
 上面的数学公式中：
 
 :math:`loc = \mu_0`：当前正态分布的平均值。
+
 :math:`scale = \sigma_0`：当前正态分布的标准差。
+
 :math:`loc = \mu_1`：另一个正态分布的平均值。
+
 :math:`scale = \sigma_1`：另一个正态分布的标准差。
+
 :math:`ratio`：两个标准差之间的比例。
+
 :math:`diff`：两个平均值之间的差值。
 
 **参数**
diff --git a/docs/api/paddle/distribution/PowerTransform_cn.rst b/docs/api/paddle/distribution/PowerTransform_cn.rst
index 6b7148ef612..1396aec342f 100644
--- a/docs/api/paddle/distribution/PowerTransform_cn.rst
+++ b/docs/api/paddle/distribution/PowerTransform_cn.rst
@@ -26,6 +26,8 @@ forward(x)
 
 计算正变换 :math:`y=f(x)` 的结果。
 
+有助于将一个随机结果变成另一个随机结果。
+
 **参数**
 
 - **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
@@ -39,7 +41,7 @@ forward(x)
 inverse(y)
 '''''''''
 
-计算逆变换 :math:`x = f^{-1}(y)`
+计算逆变换 :math:`x = f^{-1}(y)`。
 
 **参数**
 
diff --git a/docs/api/paddle/distribution/ReshapeTransform_cn.rst b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
index b89d51c3767..951b25c6ed1 100644
--- a/docs/api/paddle/distribution/ReshapeTransform_cn.rst
+++ b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
@@ -42,7 +42,7 @@ forward(x)
 inverse(y)
 '''''''''
 
-计算逆变换 :math:`x = f^{-1}(y)`
+计算逆变换 :math:`x = f^{-1}(y)`。
 
 **参数**
 
diff --git a/docs/api/paddle/distribution/SigmoidTransform_cn.rst b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
index b34e2117879..29e59d79189 100644
--- a/docs/api/paddle/distribution/SigmoidTransform_cn.rst
+++ b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
@@ -34,7 +34,7 @@ forward(x)
 inverse(y)
 '''''''''
 
-计算逆变换 :math:`x = f^{-1}(y)`
+计算逆变换 :math:`x = f^{-1}(y)`。
 
 **参数**
 
diff --git a/docs/api/paddle/distribution/SoftmaxTransform_cn.rst b/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
index 55ba1d2394f..78e055742af 100644
--- a/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
+++ b/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
@@ -38,7 +38,7 @@ forward(x)
 inverse(y)
 '''''''''
 
-计算逆变换 :math:`x = f^{-1}(y)`
+计算逆变换 :math:`x = f^{-1}(y)`。
 
 **参数**
 
diff --git a/docs/api/paddle/distribution/StackTransform_cn.rst b/docs/api/paddle/distribution/StackTransform_cn.rst
index d7be31bd51c..83acb92f056 100644
--- a/docs/api/paddle/distribution/StackTransform_cn.rst
+++ b/docs/api/paddle/distribution/StackTransform_cn.rst
@@ -39,7 +39,7 @@ forward(x)
 inverse(y)
 '''''''''
 
-计算逆变换 :math:`x = f^{-1}(y)`
+计算逆变换 :math:`x = f^{-1}(y)`。
 
 **参数**
 

From b72871ec9544f9129187fe569abeaeda464f80ce Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 11:42:35 +0800
Subject: [PATCH 03/31] Update clone_cn.rst

fix
---
 docs/api/paddle/clone_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/clone_cn.rst b/docs/api/paddle/clone_cn.rst
index 7ad75edc280..5811b8eda5b 100644
--- a/docs/api/paddle/clone_cn.rst
+++ b/docs/api/paddle/clone_cn.rst
@@ -11,7 +11,7 @@ clone
 
 参数
 :::::::::
-    - x (Tensor) - 输入 Tensor。
+    - **x** (Tensor) - 输入 Tensor。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

From 3cb25f79c9d228e66edd57b69979a57477c7422f Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 11:49:58 +0800
Subject: [PATCH 04/31] Update erfinv_cn.rst

fix
---
 docs/api/paddle/erfinv_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/erfinv_cn.rst b/docs/api/paddle/erfinv_cn.rst
index 72d20c70ceb..641bf4976e1 100644
--- a/docs/api/paddle/erfinv_cn.rst
+++ b/docs/api/paddle/erfinv_cn.rst
@@ -3,7 +3,7 @@
 erfinv
 -------------------------------
 
-.. py:function:: paddle.erfinv(x)
+.. py:function:: paddle.erfinv(x,Name=None)
 计算输入矩阵 x 的逆误差函数。
 请参考 erf 计算公式 :ref:`cn_api_fluid_layers_erf`
 

From 1f495b64f589bb7c5245c844f078db8ed7aa5ccf Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 14:02:11 +0800
Subject: [PATCH 05/31] Update heaviside_cn.rst

fix links
---
 docs/api/paddle/heaviside_cn.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/api/paddle/heaviside_cn.rst b/docs/api/paddle/heaviside_cn.rst
index 2b8eb7215f5..a1e54e16adc 100644
--- a/docs/api/paddle/heaviside_cn.rst
+++ b/docs/api/paddle/heaviside_cn.rst
@@ -6,7 +6,7 @@ heaviside
 .. py:function:: paddle.heaviside(x, y, name=None)
 
 
-逐元素地对 Tensor `x` 计算由 Tensor `y` 中的对应元素决定的赫维赛德阶跃函数，其计算公式为
+为 `x` 中的每个元素计算由 `y` 中相对应元素决定的赫维赛德阶跃函数，其计算公式为
 
 .. math::
    \mathrm{heaviside}(x, y)=
@@ -19,7 +19,7 @@ heaviside
       \right.
 
 .. note::
-   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`cn_user_guide_broadcasting`。
+   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`broadcast_cn.html`。
 
 参数
 :::::::::

From 021914fa0cef80bbff64ce3a702f0fd787c85175 Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 14:08:49 +0800
Subject: [PATCH 06/31] Update heaviside_cn.rst

fix links
---
 docs/api/paddle/heaviside_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/heaviside_cn.rst b/docs/api/paddle/heaviside_cn.rst
index a1e54e16adc..1e0d5b5eefa 100644
--- a/docs/api/paddle/heaviside_cn.rst
+++ b/docs/api/paddle/heaviside_cn.rst
@@ -19,7 +19,7 @@ heaviside
       \right.
 
 .. note::
-   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`broadcast_cn.html`。
+   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`cn_api_paddle_distributed_broadcast`。
 
 参数
 :::::::::

From a07fb8d8505218e34b9d3ecbb702ede9e272852c Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 17:20:39 +0800
Subject: [PATCH 07/31] Update heaviside_cn.rst

fix
---
 docs/api/paddle/heaviside_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/heaviside_cn.rst b/docs/api/paddle/heaviside_cn.rst
index 1e0d5b5eefa..380db8ae913 100644
--- a/docs/api/paddle/heaviside_cn.rst
+++ b/docs/api/paddle/heaviside_cn.rst
@@ -19,7 +19,7 @@ heaviside
       \right.
 
 .. note::
-   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`cn_api_paddle_distributed_broadcast`。
+   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id7`。
 
 参数
 :::::::::

From 3c21a943e35fd57db5bd27aad31315fc57687b56 Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 17:24:31 +0800
Subject: [PATCH 08/31] Update log_loss_cn.rst

update
---
 docs/api/paddle/nn/functional/log_loss_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/nn/functional/log_loss_cn.rst b/docs/api/paddle/nn/functional/log_loss_cn.rst
index 7655477e3f5..d84d586f15d 100644
--- a/docs/api/paddle/nn/functional/log_loss_cn.rst
+++ b/docs/api/paddle/nn/functional/log_loss_cn.rst
@@ -22,7 +22,7 @@ log_loss
 
   - **input** (Tensor) – 形为 [N x 1] 的二维张量，其中 N 为 batch 大小。该输入是由前驱算子计算得来的概率，数据类型是 float32。
   - **label** (Tensor) – 形为 [N x 1] 的二维张量，真值标签，其中 N 为 batch 大小，数据类型是 float32。
-  - **epsilon** (float) – 一个很小的数字，以保证数值的稳定性，默认值为 1e-4。
+  - **epsilon** (float，可选) – 一个很小的数字，以保证数值的稳定性，默认值为 1e-4。
   - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

From 865f7548ca7243c26eec409914f8e4e0d86ad739 Mon Sep 17 00:00:00 2001
From: Infinity_lee <luhputu0815@gmail.com>
Date: Fri, 16 Sep 2022 17:25:28 +0800
Subject: [PATCH 09/31] Update erfinv_cn.rst

update
---
 docs/api/paddle/erfinv_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/erfinv_cn.rst b/docs/api/paddle/erfinv_cn.rst
index 641bf4976e1..711d73e4332 100644
--- a/docs/api/paddle/erfinv_cn.rst
+++ b/docs/api/paddle/erfinv_cn.rst
@@ -3,7 +3,7 @@
 erfinv
 -------------------------------
 
-.. py:function:: paddle.erfinv(x,Name=None)
+.. py:function:: paddle.erfinv(x, name=None)
 计算输入矩阵 x 的逆误差函数。
 请参考 erf 计算公式 :ref:`cn_api_fluid_layers_erf`
 

From 9d61505df0ab24060b816817f304c30a1010a65e Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:07:28 +0800
Subject: [PATCH 10/31] Update log_loss_cn.rst

---
 docs/api/paddle/nn/functional/log_loss_cn.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/api/paddle/nn/functional/log_loss_cn.rst b/docs/api/paddle/nn/functional/log_loss_cn.rst
index d84d586f15d..c3f89790d8c 100644
--- a/docs/api/paddle/nn/functional/log_loss_cn.rst
+++ b/docs/api/paddle/nn/functional/log_loss_cn.rst
@@ -10,7 +10,7 @@ log_loss
 
 **负 log loss 层**
 
-该 OP 对输入的预测结果和目标标签进行计算，返回负对数损失值。
+对输入的预测结果和目标标签进行计算，返回负对数损失值。
 
 .. math::
 
@@ -20,16 +20,15 @@ log_loss
 参数
 ::::::::::::
 
-  - **input** (Tensor) – 形为 [N x 1] 的二维张量，其中 N 为 batch 大小。该输入是由前驱算子计算得来的概率，数据类型是 float32。
-  - **label** (Tensor) – 形为 [N x 1] 的二维张量，真值标签，其中 N 为 batch 大小，数据类型是 float32。
+  - **input** (Tensor) – 形为 :math:`[N, 1]` 的二维张量，其中 :math:`N` 为 batch 大小。该输入是由前驱算子计算得来的概率，数据类型是 float32。
+  - **label** (Tensor) – 形为 :math:`[N, 1]` 的二维张量，真值标签，其中 :math:`N` 为 batch 大小，数据类型是 float32。
   - **epsilon** (float，可选) – 一个很小的数字，以保证数值的稳定性，默认值为 1e-4。
   - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
 ::::::::::::
- Tensor，形状为[N x 1]，数据类型为 float32
-
 
+Tensor，形状为 :math:`[N, 1]`，数据类型为 float32。
 
 代码示例
 ::::::::::::

From db877e749bab793b05adeb0802bea707247f60c1 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:11:44 +0800
Subject: [PATCH 11/31] Update heaviside_cn.rst

---
 docs/api/paddle/heaviside_cn.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/api/paddle/heaviside_cn.rst b/docs/api/paddle/heaviside_cn.rst
index 380db8ae913..834567c5b19 100644
--- a/docs/api/paddle/heaviside_cn.rst
+++ b/docs/api/paddle/heaviside_cn.rst
@@ -6,7 +6,7 @@ heaviside
 .. py:function:: paddle.heaviside(x, y, name=None)
 
 
-为 `x` 中的每个元素计算由 `y` 中相对应元素决定的赫维赛德阶跃函数，其计算公式为
+为 :attr:`x` 中的每个元素计算由 :attr:`y` 中相对应元素决定的赫维赛德阶跃函数，其计算公式为
 
 .. math::
    \mathrm{heaviside}(x, y)=
@@ -19,17 +19,18 @@ heaviside
       \right.
 
 .. note::
-   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/beginner/tensor_cn.html#id7`。
+   ``paddle.heaviside`` 遵守广播机制，如您想了解更多，请参见 :ref:`cn_user_guide_broadcasting`。
 
 参数
 :::::::::
-   - **x** （Tensor）- 赫维赛德阶跃函数的输入 Tensor。数据类型为 float16、float32、float64、int32 或 int64。
-   - **y** （Tensor）- 决定了一个赫维赛德阶跃函数的 Tensor。数据类型为 float16、float32、float64、int32 或 int64。
+   - **x** (Tensor) - 赫维赛德阶跃函数的输入 Tensor。数据类型为 float16、float32、float64、int32 或 int64。
+   - **y** (Tensor) - 决定了一个赫维赛德阶跃函数的 Tensor。数据类型为 float16、float32、float64、int32 或 int64。
    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
 :::::::::
-   `Tensor`，存储运算后的结果。如果 `x` 和 `y` 有不同的形状且是可以广播的，那么返回 Tensor 的形状是 `x` 和 `y` 经过广播后的形状。如果 `x` 和 `y` 有相同的形状，那么返回 Tensor 的形状与 `x` 和 `y` 相同。
+
+`Tensor`，存储运算后的结果。如果 :attr:`x` 和 :attr:`y` 有不同的形状且是可以广播的，那么返回 Tensor 的形状是 :attr:`x` 和 :attr:`y` 经过广播后的形状。如果 :attr:`x` 和 :attr:`y` 有相同的形状，那么返回 Tensor 的形状与 :attr:`x` 和 :attr:`y` 相同。
 
 
 代码示例

From 3cd788b26b0eb7d272f6f81c67c59ef20477e3b9 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:12:42 +0800
Subject: [PATCH 12/31] Update erfinv_cn.rst

---
 docs/api/paddle/erfinv_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/erfinv_cn.rst b/docs/api/paddle/erfinv_cn.rst
index 711d73e4332..8da17f7548e 100644
--- a/docs/api/paddle/erfinv_cn.rst
+++ b/docs/api/paddle/erfinv_cn.rst
@@ -19,7 +19,7 @@ erfinv
 返回
 :::::::::
 
-输出 Tensor，与 ``x`` 数据类型相同。
+输出 Tensor，与 :attr:`x` 数据类型相同。
 
 代码示例
 :::::::::

From df51b3402a5f4d3bb48a2f21990e76584b002afe Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:14:20 +0800
Subject: [PATCH 13/31] Update StackTransform_cn.rst

---
 docs/api/paddle/distribution/StackTransform_cn.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api/paddle/distribution/StackTransform_cn.rst b/docs/api/paddle/distribution/StackTransform_cn.rst
index 83acb92f056..d097f86fbaa 100644
--- a/docs/api/paddle/distribution/StackTransform_cn.rst
+++ b/docs/api/paddle/distribution/StackTransform_cn.rst
@@ -54,7 +54,7 @@ forward_log_det_jacobian(x)
 
 计算正变换雅可比行列式绝对值的对数。
 
-如果变换不是一一映射，则雅可比矩阵不存在，返回 ``NotImplementedError`` 。
+如果变换不是一一映射，则雅可比矩阵不存在，抛出 ``NotImplementedError``。
 
 **参数**
 

From 1f3f1bab735c596b5087402575fabd7fccd2f82f Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:19:36 +0800
Subject: [PATCH 14/31] Update grid_sample_cn.rst

---
 .../paddle/nn/functional/grid_sample_cn.rst   | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/api/paddle/nn/functional/grid_sample_cn.rst b/docs/api/paddle/nn/functional/grid_sample_cn.rst
index a4e2aac7767..d7d9ff0ff7e 100644
--- a/docs/api/paddle/nn/functional/grid_sample_cn.rst
+++ b/docs/api/paddle/nn/functional/grid_sample_cn.rst
@@ -8,14 +8,13 @@ grid_sample
 
 
 
-基于 flow field 网格的对输入 X 进行双线性插值采样。网格通常由 affine_grid 生成，当输入 X 为 4 维时，网格 shape 为[N, H, W, 2]，是 shape 为[N, H, W]的采样点张量的(x, y)坐标。
-其中，x 坐标是对输入数据 X 的第四个维度(宽度维度)的索引，y 坐标是第三维度(高维度)的索引，最终输出采样值为采样点的 4 个最接近的角点的双线性插值结果，输出张量的 shape 为[N, C, H, W]。
-当输入 X 为 5 维时，网格 shape 为[N, D, H, W, 3]，是 shape 为[N, D, H, W]的采样点张量的(x, y, z)坐标。其中，x 坐标是对输入数据 X 的第五个维度(宽度维度)的索引，y 坐标是第四维度
-(高度维度)的索引，z 坐标是对输入数据 X 的第三个维度(深度维度)的索引，最终输出采样值为采样点的 8 个最接近的角点的双线性插值结果，输出张量的 shape 为[N, C, D, H, W]。
+基于 flow field 网格的对输入 X 进行双线性插值采样。网格通常由 affine_grid 生成，当输入 X 为 4 维时，网格 shape 为 :math:`[N, H, W, 2]`，是 shape 为 :math:`[N, H, W]` 的采样点张量的 (x, y) 坐标。
+其中，x 坐标是对输入数据 X 的第四个维度（宽度维度）的索引，y 坐标是第三维度(高维度)的索引，最终输出采样值为采样点的 4 个最接近的角点的双线性插值结果，输出张量的 shape 为 :math:`[N, C, H, W]`。
+当输入 X 为 5 维时，网格 shape 为 :math:`[N, D, H, W, 3]`，是 shape 为 :math:`[N, D, H, W]` 的采样点张量的 (x, y, z) 坐标。其中，x 坐标是对输入数据 X 的第五个维度（宽度维度）的索引，y 坐标是第四维度（高度维度）的索引，z 坐标是对输入数据 X 的第三个维度（深度维度）的索引，最终输出采样值为采样点的 8 个最接近的角点的双线性插值结果，输出张量的 shape 为 :math:`[N, C, D, H, W]`。
 
 step 1：
 
-  得到(x, y)网格坐标，缩放到[0,h -1/W-1]
+  得到 (x, y) 网格坐标，缩放到 :math:`[0, \frac{h-1}{W-1}]`。
 
 .. code-block:: text
 
@@ -24,7 +23,7 @@ step 1：
 
 step 2：
 
-  在每个[H, W]区域用网格(X, y)作为输入数据 X 的索引，并将双线性插值点值由 4 个最近的点表示。
+  在每个 :math:`[H, W]` 区域用网格 (X, y) 作为输入数据 X 的索引，并将双线性插值点值由 4 个最近的点表示。
 
 .. code-block:: text
 
@@ -60,14 +59,15 @@ step 2：
 
   - **x** (Tensor) - 输入张量，维度为 :math:`[N, C, H, W]` 的 4-D Tensor 或维度为 :math:`[N, C, D, H, W]` 的 5-D Tensor，N 为批尺寸，C 是通道数，D 是特征深度，H 是特征高度，W 是特征宽度，数据类型为 float32 或 float64。
   - **grid** (Tensor) - 输入网格数据张量，维度为 :math:`[N, H, W, 2]` 的 4-D Tensor 或维度为 :math:`[N, D, H, W, 3]` 的 5-D Tensor，N 为批尺寸，H 是特征高度，D 是特征深度，W 是特征宽度，数据类型为 float32 或 float64。
-  - **mode** (str，可选) - 插值方式，可以为 'bilinear' 或者 'nearest'。默认值：'bilinear'。
-  - **padding_mode** (str，可选) - 当原来的索引超过输入的图像大小时的填充方式。可以为 'zeros', 'reflection' 和 'border'。默认值：'zeros'。
-  - **align_corners** (bool，可选) - 一个可选的 bool 型参数，如果为 True，则将输入和输出张量的 4 个或 8 个角落像素的中心对齐，并保留角点像素的值。默认值：True。
+  - **mode** (str，可选) - 插值方式，可以为 'bilinear' 或者 'nearest'。默认值为 'bilinear'。
+  - **padding_mode** (str，可选) - 当原来的索引超过输入的图像大小时的填充方式。可以为 'zeros', 'reflection' 和 'border'。默认值为 'zeros'。
+  - **align_corners** (bool，可选) - 一个可选的 bool 型参数，如果为 True，则将输入和输出张量的 4 个或 8 个角落像素的中心对齐，并保留角点像素的值。默认值为 True。
   - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
 ::::::::::::
-Tensor，输入 X 基于输入网格的双线性插值计算结果，维度为 :math:`[N, C, H, W]` 的 4-D Tensor 或维度为 :math:`[N, C, D, H, W]` 的 5-D Tensor， grid_H 是 grid 的特征高度， grid_W 是 grid 的特征深度，数据类型与 ``x`` 一致。
+
+Tensor，输入 X 基于输入网格的双线性插值计算结果，维度为 :math:`[N, C, H, W]` 的 4-D Tensor 或维度为 :math:`[N, C, D, H, W]` 的 5-D Tensor， grid_H 是 grid 的特征高度， grid_W 是 grid 的特征深度，数据类型与 :attr:`x` 一致。
 
 
 代码示例

From 0f8586748332cea74a578a86f57bcf358a0a31b0 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:21:27 +0800
Subject: [PATCH 15/31] Update glu_cn.rst

---
 docs/api/paddle/nn/functional/glu_cn.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/api/paddle/nn/functional/glu_cn.rst b/docs/api/paddle/nn/functional/glu_cn.rst
index dd9262b5263..284adfa6d14 100644
--- a/docs/api/paddle/nn/functional/glu_cn.rst
+++ b/docs/api/paddle/nn/functional/glu_cn.rst
@@ -5,8 +5,7 @@ glu
 
 .. py:function:: paddle.nn.functional.glu(x, axis=-1, name=None)
 
-门控线性单元。输入按照给定的维度二等分，其中第一部分被用作内容，第二部分经过一个 sigmoid 函数
-之后被用作门限。输入是内容和门限的逐元素乘积。
+门控线性单元。输入按照给定的维度二等分，其中第一部分被用作内容，第二部分经过一个 sigmoid 函数之后被用作门限。输入是内容和门限的逐元素乘积。
 
 .. math::
     \mathrm{GLU}(a, b) = a \otimes \sigma(b)
@@ -15,14 +14,16 @@ glu
 ::::::::::::
 
 ::::::::::
- - **x** (Tensor) - 输入的 ``Tensor``，数据类型为：float32、float64。
- - **axis** (int，可选) - 沿着该轴将输入二等分。D 为输入的维数，则 ``axis`` 应该在 [-D, D) 的范围内。如 ``axis`` 为负数，则相当于 ``axis +D``。
+ - **x** (Tensor) - 输入的 ``Tensor``，数据类型为 float32 或 float64。
+ - **axis** (int，可选) - 沿着该轴将输入二等分。:math:`D` 为输入的维数，则 :attr:`axis` 应该在 :math:`[-D, D)` 的范围内。如 :attr:`axis` 为负数，则相当于 :math:`axis + D`。
  - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
 ::::::::::
-    ``Tensor``，数据类型同 ``x`` 一致，在指定的轴上其尺寸减半。
+
+``Tensor``，数据类型同 :attr:`x` 一致，在指定的轴上其尺寸减半。
 
 代码示例
 ::::::::::
+
 COPY-FROM: paddle.nn.functional.glu

From 3a6b2863af6e7963456dcf05f75ac0304c7bda49 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:22:29 +0800
Subject: [PATCH 16/31] Update clone_cn.rst

---
 docs/api/paddle/clone_cn.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/api/paddle/clone_cn.rst b/docs/api/paddle/clone_cn.rst
index 5811b8eda5b..c1fce93d469 100644
--- a/docs/api/paddle/clone_cn.rst
+++ b/docs/api/paddle/clone_cn.rst
@@ -5,18 +5,20 @@ clone
 
 .. py:function:: paddle.clone(x, name=None)
 
-对输入 Tensor ``x`` 进行拷贝，并返回一个新的 Tensor。
+对输入 Tensor :attr:`x` 进行拷贝，并返回一个新的 Tensor。
 
 除此之外，该 API 提供梯度计算，在计算反向时，输出 Tensor 的梯度将会回传给输入 Tensor。
 
 参数
 :::::::::
+
     - **x** (Tensor) - 输入 Tensor。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回
 :::::::::
-``Tensor``，从输入拷贝的 Tensor
+
+``Tensor``，从输入 :attr:`x` 拷贝的 Tensor。
 
 代码示例
 :::::::::

From fcca32fef5ec22ee68ae7a4beeccebb9c9189a08 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:27:18 +0800
Subject: [PATCH 17/31] Update IndependentTransform_cn.rst

---
 .../distribution/IndependentTransform_cn.rst      | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/docs/api/paddle/distribution/IndependentTransform_cn.rst b/docs/api/paddle/distribution/IndependentTransform_cn.rst
index 71cf8e946ed..622f245f0a0 100644
--- a/docs/api/paddle/distribution/IndependentTransform_cn.rst
+++ b/docs/api/paddle/distribution/IndependentTransform_cn.rst
@@ -6,17 +6,11 @@ IndependentTransform
 .. py:class:: paddle.distribution.IndependentTransform(base, reinterpreted_batch_rank)
 
 
- ``IndependentTransform`` 将一个基础变换 ``base`` 的部分批(batch)维度 ``reinterpreted_batch_rank`` 扩展为事件(event)维度。
+ ``IndependentTransform`` 将一个基础变换 :attr:`base` 的部分批（batch）维度 ``reinterpreted_batch_rank`` 扩展为事件（event）维度。
 
- ``IndependentTransform`` 不改变基础变换 ``forward`` 以及 ``inverse`` 计算结果，但会对
- ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 计算结果沿着扩展的维度进行求和。
+ ``IndependentTransform`` 不改变基础变换 ``forward`` 以及 ``inverse`` 计算结果，但会对 ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 计算结果沿着扩展的维度进行求和。
 
-例如，假设基础变换为 ``ExpTransform``，其输入为一个随机采样结果 ``x``，形状
-为 ``(S=[4],B=[2,2],E=[3])`` , ``S`` 、``B`` 、``E`` 分别表示采样形状、批形状、事件形状，
-``reinterpreted_batch_rank=1``。则 ``IndependentTransform(ExpTransform)``
-变换后，``x`` 的形状为 ``(S=[4],B=[2],E=[2,3])``，即将最右侧的批维度作为事件维度。
-此时 ``forward`` 和 ``inverse`` 输出形状仍是 ``(4,2,2,3)`` ,
-但 ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 输出形状为 ``(4, 2)`` 。
+例如，假设基础变换为 ``ExpTransform``，其输入为一个随机采样结果 ``x``，形状为 :math:`(S=[4], B=[2,2], E=[3])` , :math:`S`、:math:`B`、:math:`E` 分别表示采样形状、批形状、事件形状，``reinterpreted_batch_rank=1``。则 ``IndependentTransform(ExpTransform)`` 变换后，``x`` 的形状为 :math:`(S=[4], B=[2], E=[2,3])`，即将最右侧的批维度作为事件维度。此时 ``forward`` 和 ``inverse`` 输出形状仍是 :math:`[4, 2, 2, 3]`，但 ``forward_log_det_jacobian`` 以及 ``inverse_log_det_jacobian`` 输出形状为 :math:`[4, 2]`。
 
 
 参数
@@ -41,8 +35,7 @@ forward(x)
 
 **参数**
 
-- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
-  的随机采样结果。
+- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution` 的随机采样结果。
 
 **返回**
 

From a51ee9da5ec2e3fdf4ffce60eda911c480bdfe61 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:28:44 +0800
Subject: [PATCH 18/31] Update Multinomial_cn.rst

---
 docs/api/paddle/distribution/Multinomial_cn.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/docs/api/paddle/distribution/Multinomial_cn.rst b/docs/api/paddle/distribution/Multinomial_cn.rst
index 78e27752d83..f6798a46d53 100644
--- a/docs/api/paddle/distribution/Multinomial_cn.rst
+++ b/docs/api/paddle/distribution/Multinomial_cn.rst
@@ -7,8 +7,7 @@ Multinomial
 
 ``Multinomial`` 表示实验次数为 ``total_count``，概率为 ``probs`` 的多项分布。
 
-在概率论中，多项分布是二项分布的多元推广，表示具有 :math:`k` 个类别的事件重复实验 :math:`n`
-次，每个类别出现次数的概率。当 :math:`k=2` 且 :math:`n=1` 时，为伯努利分布，当 :math:`k=2` 且 :math:`n>1` 时，为二项分布，当 :math:`k>2` 且 :math:`n=1` 时，为分类分布。
+在概率论中，多项分布是二项分布的多元推广，表示具有 :math:`k` 个类别的事件重复实验 :math:`n` 次，每个类别出现次数的概率。当 :math:`k=2` 且 :math:`n=1` 时，为伯努利分布，当 :math:`k=2` 且 :math:`n>1` 时，为二项分布，当 :math:`k>2` 且 :math:`n=1` 时，为分类分布。
 
 多项分布概率密度函数如下：
 
@@ -17,8 +16,7 @@ Multinomial
     f(x_1, ..., x_k; n, p_1,...,p_k) = \frac{n!}{x_1!...x_k!}p_1^{x_1}...p_k^{x_k}
 
 
-其中，:math:`n` 表示实验次数，:math:`k` 表示类别数，:math:`p_i` 表示一次实验中，实验结果
-为第 :math:`i` 个类别的概率，需要满足 :math:`{\textstyle \sum_{i=1}^{k}p_i=1}, p_i \ge 0` , :math:`x_i` 表示第 :math:`i` 个分类出现的次数。
+其中，:math:`n` 表示实验次数，:math:`k` 表示类别数，:math:`p_i` 表示一次实验中，实验结果为第 :math:`i` 个类别的概率，需要满足 :math:`{\textstyle \sum_{i=1}^{k}p_i=1}, p_i \ge 0` , :math:`x_i` 表示第 :math:`i` 个分类出现的次数。
 
 
 
@@ -26,8 +24,7 @@ Multinomial
 :::::::::
 
 - **total_count** (int) - 实验次数。
-- **probs** （Tensor） - 每个类别发生的概率。最后一维为事件维度，其它维为批维度。``probs`` 中
-  的每个元素取值范围为 ``[0,1]``。如果输入数据大于 1，会沿着最后一维进行归一化操作。
+- **probs** (Tensor) - 每个类别发生的概率。最后一维为事件维度，其它维为批维度。:attr:`probs` 中的每个元素取值范围为 :math:`[0, 1]`。如果输入数据大于 1，会沿着最后一维进行归一化操作。
 
 代码示例
 :::::::::

From 066b359f8425592a9f6ea7a1579ff3a55b35c598 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:33:29 +0800
Subject: [PATCH 19/31] Update Normal_cn.rst

---
 docs/api/paddle/distribution/Normal_cn.rst | 27 +++++++++-------------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/docs/api/paddle/distribution/Normal_cn.rst b/docs/api/paddle/distribution/Normal_cn.rst
index b98fe6ac8ca..7ea0437b8d6 100644
--- a/docs/api/paddle/distribution/Normal_cn.rst
+++ b/docs/api/paddle/distribution/Normal_cn.rst
@@ -20,15 +20,15 @@ Normal
 
 上面的数学公式中：
 
-:math:`loc = \mu`：平均值。
-:math:`scale = \sigma`：标准差。
-:math:`Z`：正态分布常量。
+- :math:`loc = \mu`：平均值。
+- :math:`scale = \sigma`：标准差。
+- :math:`Z`：正态分布常量。
 
 参数
 ::::::::::::
 
-    - **loc** (int|float|list|numpy.ndarray|Tensor) - 正态分布平均值。数据类型为 int、float、list、numpy.ndarray 或 Tensor。
-    - **scale** (int|float|list|numpy.ndarray|Tensor) - 正态分布标准差。数据类型为 int、float、list、numpy.ndarray 或 Tensor。
+    - **loc** (int|float|list|numpy.ndarray|Tensor) - 正态分布平均值。数据类型为 float32 或 float64。
+    - **scale** (int|float|list|numpy.ndarray|Tensor) - 正态分布标准差。数据类型为 float32 或 float64。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 代码示例
@@ -116,17 +116,12 @@ kl_divergence(other)
 
 上面的数学公式中：
 
-:math:`loc = \mu_0`：当前正态分布的平均值。
-
-:math:`scale = \sigma_0`：当前正态分布的标准差。
-
-:math:`loc = \mu_1`：另一个正态分布的平均值。
-
-:math:`scale = \sigma_1`：另一个正态分布的标准差。
-
-:math:`ratio`：两个标准差之间的比例。
-
-:math:`diff`：两个平均值之间的差值。
+- :math:`loc = \mu_0`：当前正态分布的平均值；
+- :math:`scale = \sigma_0`：当前正态分布的标准差；
+- :math:`loc = \mu_1`：另一个正态分布的平均值；
+- :math:`scale = \sigma_1`：另一个正态分布的标准差；
+- :math:`ratio`：两个标准差之间的比例；
+- :math:`diff`：两个平均值之间的差值。
 
 **参数**
 

From e68bf48aa3d89ac6d43bdd486039fa7e5844d96b Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:34:25 +0800
Subject: [PATCH 20/31] Update PowerTransform_cn.rst

---
 docs/api/paddle/distribution/PowerTransform_cn.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/api/paddle/distribution/PowerTransform_cn.rst b/docs/api/paddle/distribution/PowerTransform_cn.rst
index 1396aec342f..7dd5c0c6fff 100644
--- a/docs/api/paddle/distribution/PowerTransform_cn.rst
+++ b/docs/api/paddle/distribution/PowerTransform_cn.rst
@@ -5,7 +5,7 @@ PowerTransform
 
 .. py:class:: paddle.distribution.PowerTransform(power)
 
-幂变换 :math:`y = x^{power}` 。
+幂变换 :math:`y = x^{power}`。
 
 参数
 :::::::::
@@ -56,7 +56,7 @@ forward_log_det_jacobian(x)
 
 计算正变换雅可比行列式绝对值的对数。
 
-如果变换不是一一映射，则雅可比矩阵不存在，返回 ``NotImplementedError`` 。
+如果变换不是一一映射，则雅可比矩阵不存在，抛出 ``NotImplementedError`` 。
 
 **参数**
 

From 6683e4fc2362aa38a7abdd4a73dd5250fe8cd6d3 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:46:03 +0800
Subject: [PATCH 21/31] Update ReshapeTransform_cn.rst

---
 .../paddle/distribution/ReshapeTransform_cn.rst   | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/docs/api/paddle/distribution/ReshapeTransform_cn.rst b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
index 951b25c6ed1..4bb5c7f6426 100644
--- a/docs/api/paddle/distribution/ReshapeTransform_cn.rst
+++ b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
@@ -31,12 +31,11 @@ forward(x)
 
 **参数**
 
-- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
-  的随机采样结果。
+- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution` 的随机采样结果。
 
 **返回**
 
-- **y** (Tensor) - 正变换的计算结果。
+Tensor，正变换的计算结果。
 
 
 inverse(y)
@@ -50,7 +49,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -65,7 +64,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -81,7 +80,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -95,7 +94,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -109,4 +108,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From 26301679ae4845e9f745507dd1ca49edd1c2d726 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:47:07 +0800
Subject: [PATCH 22/31] Update SigmoidTransform_cn.rst

---
 docs/api/paddle/distribution/SigmoidTransform_cn.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/api/paddle/distribution/SigmoidTransform_cn.rst b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
index 29e59d79189..9c9cee38c46 100644
--- a/docs/api/paddle/distribution/SigmoidTransform_cn.rst
+++ b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
@@ -28,7 +28,7 @@ forward(x)
 
 **返回**
 
-- **y** (Tensor) - 正变换的计算结果。
+Tensor，正变换的计算结果。
 
 
 inverse(y)
@@ -42,7 +42,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -57,7 +57,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -73,7 +73,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -87,7 +87,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -101,4 +101,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From 97c450a9640724b0122253fdb2ad788710af9528 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:48:22 +0800
Subject: [PATCH 23/31] Update SoftmaxTransform_cn.rst

---
 .../paddle/distribution/SoftmaxTransform_cn.rst   | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/docs/api/paddle/distribution/SoftmaxTransform_cn.rst b/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
index 78e055742af..d37e4ef4752 100644
--- a/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
+++ b/docs/api/paddle/distribution/SoftmaxTransform_cn.rst
@@ -10,7 +10,7 @@ Softmax 变换，首先进行 :math:`y = exp(x)` 变换，然后归一化。
 Softmax 变换将向量变换为单纯形。
 
 .. note::
-Softmax 不是双射函数，所以 ``forward_log_det_jacobian`` 、 ``inverse_log_det_jacobian`` 未实现。
+   Softmax 不是双射函数，所以 ``forward_log_det_jacobian``、``inverse_log_det_jacobian`` 未实现。
 
 代码示例
 :::::::::
@@ -27,8 +27,7 @@ forward(x)
 
 **参数**
 
-- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
-  的随机采样结果。
+- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution` 的随机采样结果。
 
 **返回**
 
@@ -46,7 +45,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -61,7 +60,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -77,7 +76,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -91,7 +90,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -105,4 +104,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From 99a5aa4605071c6c6e308f31af5a1e0fc1f9ceba Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:49:35 +0800
Subject: [PATCH 24/31] Update StackTransform_cn.rst

---
 docs/api/paddle/distribution/StackTransform_cn.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/api/paddle/distribution/StackTransform_cn.rst b/docs/api/paddle/distribution/StackTransform_cn.rst
index d097f86fbaa..be4abe72e22 100644
--- a/docs/api/paddle/distribution/StackTransform_cn.rst
+++ b/docs/api/paddle/distribution/StackTransform_cn.rst
@@ -11,7 +11,7 @@ StackTransform
 :::::::::
 
 - **transforms** (Sequence[Transform]) - 变换序列。
-- **axis** (int，可选） - 待变换的轴，默认值：0，表示沿着第 0 个轴变换。
+- **axis** (int，可选) - 待变换的轴，默认值：0，表示沿着第 0 个轴变换。
 
 代码示例
 :::::::::
@@ -33,7 +33,7 @@ forward(x)
 
 **返回**
 
-- **y** (Tensor) - 正变换的计算结果。
+Tensor，正变换的计算结果。
 
 
 inverse(y)
@@ -47,7 +47,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -62,7 +62,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -78,7 +78,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -92,7 +92,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -106,4 +106,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From 60ae141fa647c0e98640d3635a82b8874d98d0b6 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:50:51 +0800
Subject: [PATCH 25/31] Update IndependentTransform_cn.rst

---
 .../paddle/distribution/IndependentTransform_cn.rst  | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/api/paddle/distribution/IndependentTransform_cn.rst b/docs/api/paddle/distribution/IndependentTransform_cn.rst
index 622f245f0a0..412fdef0f08 100644
--- a/docs/api/paddle/distribution/IndependentTransform_cn.rst
+++ b/docs/api/paddle/distribution/IndependentTransform_cn.rst
@@ -39,7 +39,7 @@ forward(x)
 
 **返回**
 
-- **y** (Tensor) - 正变换的计算结果。
+Tensor，正变换的计算结果。
 
 
 inverse(y)
@@ -53,7 +53,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -68,7 +68,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -84,7 +84,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -98,7 +98,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -112,4 +112,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From e213c11c85d848c5411b41dae7a94fbbc67b8c4b Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:52:27 +0800
Subject: [PATCH 26/31] Update Multinomial_cn.rst

---
 docs/api/paddle/distribution/Multinomial_cn.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/api/paddle/distribution/Multinomial_cn.rst b/docs/api/paddle/distribution/Multinomial_cn.rst
index f6798a46d53..594a2d8ddce 100644
--- a/docs/api/paddle/distribution/Multinomial_cn.rst
+++ b/docs/api/paddle/distribution/Multinomial_cn.rst
@@ -5,7 +5,7 @@ Multinomial
 
 .. py:class:: paddle.distribution.Multinomial(total_count, probs)
 
-``Multinomial`` 表示实验次数为 ``total_count``，概率为 ``probs`` 的多项分布。
+``Multinomial`` 表示实验次数为 :attr:`total_count`，概率为 :attr:`probs` 的多项分布。
 
 在概率论中，多项分布是二项分布的多元推广，表示具有 :math:`k` 个类别的事件重复实验 :math:`n` 次，每个类别出现次数的概率。当 :math:`k=2` 且 :math:`n=1` 时，为伯努利分布，当 :math:`k=2` 且 :math:`n>1` 时，为二项分布，当 :math:`k>2` 且 :math:`n=1` 时，为分类分布。
 
@@ -60,7 +60,7 @@ prob(value)
 
 **返回**
 
-- Tensor: value 的概率。
+Tensor，:attr:`value` 的概率。
 
 
 log_prob(value)
@@ -74,7 +74,7 @@ log_prob(value)
 
 **返回**
 
-- Tensor: value 的对数概率。
+Tensor，:attr:`value` 的对数概率。
 
 
 sample(shape=())
@@ -88,4 +88,4 @@ sample(shape=())
 
 **返回**
 
-- Tensor：样本数据。
+Tensor，样本数据。

From d521a743abd94de16f8ffa69b3575271652f72c5 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:53:47 +0800
Subject: [PATCH 27/31] Update Normal_cn.rst

---
 docs/api/paddle/distribution/Normal_cn.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/api/paddle/distribution/Normal_cn.rst b/docs/api/paddle/distribution/Normal_cn.rst
index 7ea0437b8d6..81ee202a037 100644
--- a/docs/api/paddle/distribution/Normal_cn.rst
+++ b/docs/api/paddle/distribution/Normal_cn.rst
@@ -7,7 +7,6 @@ Normal
 
 
 
-
 正态分布
 
 数学公式：
@@ -20,8 +19,8 @@ Normal
 
 上面的数学公式中：
 
-- :math:`loc = \mu`：平均值。
-- :math:`scale = \sigma`：标准差。
+- :math:`loc = \mu`：平均值；
+- :math:`scale = \sigma`：标准差；
 - :math:`Z`：正态分布常量。
 
 参数
@@ -97,7 +96,7 @@ probs(value)
 
 **返回**
 
-Tensor，概率，数据类型与 value 相同。
+Tensor，概率，数据类型与 :attr:`value` 相同。
 
 kl_divergence(other)
 '''''''''

From 0da0ec891cde131910382e6b222ad60466b3294e Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:54:59 +0800
Subject: [PATCH 28/31] Update PowerTransform_cn.rst

---
 docs/api/paddle/distribution/PowerTransform_cn.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/api/paddle/distribution/PowerTransform_cn.rst b/docs/api/paddle/distribution/PowerTransform_cn.rst
index 7dd5c0c6fff..df201623484 100644
--- a/docs/api/paddle/distribution/PowerTransform_cn.rst
+++ b/docs/api/paddle/distribution/PowerTransform_cn.rst
@@ -35,7 +35,7 @@ forward(x)
 
 **返回**
 
-- **y** (Tensor) - 正变换的计算结果。
+Tensor，正变换的计算结果。
 
 
 inverse(y)
@@ -49,7 +49,7 @@ inverse(y)
 
 **返回**
 
-- **x** (Tensor) - 逆变换的计算结果。
+Tensor，逆变换的计算结果。
 
 forward_log_det_jacobian(x)
 '''''''''
@@ -64,7 +64,7 @@ forward_log_det_jacobian(x)
 
 **返回**
 
-- Tensor - 正变换雅可比行列式绝对值的对数。
+Tensor，正变换雅可比行列式绝对值的对数。
 
 
 inverse_log_det_jacobian(y)
@@ -80,7 +80,7 @@ inverse_log_det_jacobian(y)
 
 **返回**
 
-- Tensor - 逆变换雅可比行列式绝对值的对数。
+Tensor，逆变换雅可比行列式绝对值的对数。
 
 
 forward_shape(shape)
@@ -94,7 +94,7 @@ forward_shape(shape)
 
 **返回**
 
-- Sequence[int] - 正变换输出的形状。
+Sequence[int]，正变换输出的形状。
 
 
 inverse_shape(shape)
@@ -108,4 +108,4 @@ inverse_shape(shape)
 
 **返回**
 
-- Sequence[int] - 逆变换输出的形状。
+Sequence[int]，逆变换输出的形状。

From dbf1b0edd6717758633ed4b1024113158c4e7b5c Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:55:56 +0800
Subject: [PATCH 29/31] Update ReshapeTransform_cn.rst

---
 docs/api/paddle/distribution/ReshapeTransform_cn.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/api/paddle/distribution/ReshapeTransform_cn.rst b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
index 4bb5c7f6426..785a8810fc5 100644
--- a/docs/api/paddle/distribution/ReshapeTransform_cn.rst
+++ b/docs/api/paddle/distribution/ReshapeTransform_cn.rst
@@ -5,8 +5,7 @@ ReshapeTransform
 
 .. py:class:: paddle.distribution.ReshapeTransform(in_event_shape, out_event_shape)
 
-``ReshapeTransform`` 将输入 Tensor 的事件形状 ``in_event_shape`` 改变为 ``out_event_shape`` 。
-其中，``in_event_shape`` 、 ``out_event_shape`` 需要包含相同的元素个数。
+``ReshapeTransform`` 将输入 Tensor 的事件形状 ``in_event_shape`` 改变为 ``out_event_shape``。其中，``in_event_shape``、``out_event_shape`` 需要包含相同的元素个数。
 
 
 参数
@@ -56,7 +55,7 @@ forward_log_det_jacobian(x)
 
 计算正变换雅可比行列式绝对值的对数。
 
-如果变换不是一一映射，则雅可比矩阵不存在，返回 ``NotImplementedError`` 。
+如果变换不是一一映射，则雅可比矩阵不存在，抛出 ``NotImplementedError``。
 
 **参数**
 

From 1d1eb61cc66df91155a5cf00765f602b0a50b479 Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:56:41 +0800
Subject: [PATCH 30/31] Update SigmoidTransform_cn.rst

---
 docs/api/paddle/distribution/SigmoidTransform_cn.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/api/paddle/distribution/SigmoidTransform_cn.rst b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
index 9c9cee38c46..2704f4f75a7 100644
--- a/docs/api/paddle/distribution/SigmoidTransform_cn.rst
+++ b/docs/api/paddle/distribution/SigmoidTransform_cn.rst
@@ -23,8 +23,7 @@ forward(x)
 
 **参数**
 
-- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
-  的随机采样结果。
+- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution` 的随机采样结果。
 
 **返回**
 

From c263a3aa5c1cdd919a30c66a260beccc2963ad1e Mon Sep 17 00:00:00 2001
From: Nyakku Shigure <sigure.qaq@gmail.com>
Date: Sat, 17 Sep 2022 17:58:10 +0800
Subject: [PATCH 31/31] Update StackTransform_cn.rst

---
 docs/api/paddle/distribution/StackTransform_cn.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/api/paddle/distribution/StackTransform_cn.rst b/docs/api/paddle/distribution/StackTransform_cn.rst
index be4abe72e22..fc8eb80cff0 100644
--- a/docs/api/paddle/distribution/StackTransform_cn.rst
+++ b/docs/api/paddle/distribution/StackTransform_cn.rst
@@ -11,7 +11,7 @@ StackTransform
 :::::::::
 
 - **transforms** (Sequence[Transform]) - 变换序列。
-- **axis** (int，可选) - 待变换的轴，默认值：0，表示沿着第 0 个轴变换。
+- **axis** (int，可选) - 待变换的轴，默认值为 0，表示沿着第 0 个轴变换。
 
 代码示例
 :::::::::
@@ -28,8 +28,7 @@ forward(x)
 
 **参数**
 
-- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution`
-  的随机采样结果。
+- **x** (Tensor) - 正变换输入参数，通常为 :ref:`cn_api_distribution_Distribution` 的随机采样结果。
 
 **返回**