背景

飞桨官网的 API 文档采用 ReStructuredText (.rst) 格式编写，经渲染后以 HTML 格式呈现。.rst 文件对缩进、空行等格式非常敏感，稍有不当便可能导致渲染异常。

目前，飞桨 API 文档中广泛使用 .. note:: 的注解语法，目的是提醒开发者使用 API 时需额外注意的事项。

以 amax 为例，官网显示的注解效果如下图红框所示

对应 .rst 源码为：

问题

目前，有部分 API 文档的注解内容未严格遵守缩进要求，导致渲染异常。例如：

正确示例如下（需缩进）：

 .. note:: 
     输出的结果不返回梯度。

经排查发现以下文件均存在类似问题，需要统一修正。

任务描述

请修复以下文件的 .. note:: 注解缩进问题，确保注解内容缩进正确，官网渲染正常。

待修复文档清单：

序号	文件路径	认领人/状态/PR
1	docs/api/paddle/add_cn.rst	@Echo-Nie #7132
2	docs/api/paddle/greater_equal_cn.rst	@Echo-Nie #7132
3	docs/api/paddle/tensordot_cn.rst	@Echo-Nie #7132
4	docs/api/paddle/linalg/eigvals_cn.rst	@Echo-Nie #7132
5	docs/api/paddle/metric/Auc_cn.rst	@hanlintang #7138 @Echo-Nie #7164
6	docs/api/paddle/metric/Precision_cn.rst	@hanlintang #7138 @Echo-Nie #7164
7	docs/api/paddle/metric/Recall_cn.rst	@hanlintang #7138 @Echo-Nie #7164
8	docs/api/paddle/nn/BatchNorm1D_cn.rst	@KANGslay #7141 @cuiyu-ai #7214
9	docs/api/paddle/nn/BatchNorm2D_cn.rst	@KANGslay #7141 @hanlintang #7222
10	docs/api/paddle/nn/BatchNorm3D_cn.rst	@KANGslay #7141 @hanlintang #7222
11	docs/api/paddle/nn/InstanceNorm1D_cn.rst	@Keywennn #7140 @Echo-Nie #7213
12	docs/api/paddle/nn/InstanceNorm2D_cn.rst	@Keywennn #7140 @Echo-Nie #7213
13	docs/api/paddle/nn/InstanceNorm3D_cn.rst	@Keywennn #7140 @Echo-Nie #7213
14	docs/api/paddle/optimizer/Adadelta_cn.rst	@Ismoothly @xxm2892 #7185 #7184 @HangFu7 #7169
15	docs/api/paddle/optimizer/Adamax_cn.rst	@Haroldlhl #7162 @xxm2892 #7185 #7184
16	docs/api/paddle/optimizer/Adam_cn.rst	@Haroldlhl #7162 @xxm2892 #7185 #7184 @cuiyu-ai #7186
17	docs/api/paddle/optimizer/Lamb_cn.rst	@Djraemon #7172 @xxm2892 #7185 #7184 @yueshehanjiang #7161
18	docs/api/paddle/optimizer/LBFGS_cn.rst	@Djraemon #7172 @xxm2892 #7185 #7184 @yueshehanjiang #7161
19	docs/api/paddle/optimizer/Momentum_cn.rst	@Kang-8846 #7145
20	docs/api/paddle/optimizer/NAdam_cn.rst	@ZMS-PNG @594233 #7148 @rich04lin #7150
21	docs/api/paddle/optimizer/Optimizer_cn.rst	@594233 #7148 @rich04lin #7150
22	docs/api/paddle/optimizer/RAdam_cn.rst	@594233 #7148 @rich04lin #7150 @Jacoblincc
23	docs/api/paddle/optimizer/RMSProp_cn.rst	@rich04lin #7150 @Jacoblincc
24	docs/api/paddle/optimizer/SGD_cn.rst	@rich04lin #7150 @Jacoblincc
25	docs/api/paddle/static/Executor_cn.rst	@zengpufan #7157 #7174 @turbozhuo #7171
26	docs/api/paddle/static/Program_cn.rst	@zengpufan #7157 @turbozhuo #7171 @cuiyu-ai #7215
27	docs/api/paddle/static/set_program_state_cn.rst	@594233 #7155
28	docs/api/paddle/static/Variable_cn.rst	@594233 #7155
29	docs/api/paddle/static/nn/conv2d_transpose_cn.rst	@rich04lin #7154 @Ericsciencer
30	docs/api/paddle/static/nn/conv3d_transpose_cn.rst	@rich04lin #7154 @Ericsciencer
31	docs/api/paddle/static/nn/embedding_cn.rst	@rich04lin #7154
32	docs/api/paddle/static/nn/sequence_concat_cn.rst	@rich04lin #7154
33	docs/api/paddle/static/nn/sequence_conv_cn.rst	@rich04lin #7154
34	docs/api/paddle/static/nn/sequence_enumerate_cn.rst	@rich04lin #7154
35	docs/api/paddle/static/nn/sequence_expand_as_cn.rst	@rich04lin #7154 @XiaoLai0-0 #7165
36	docs/api/paddle/static/nn/sequence_expand_cn.rst	@rich04lin #7154 @XiaoLai0-0 #7173
37	docs/api/paddle/static/nn/sequence_first_step_cn.rst	@rich04lin #7154 @quite125
38	docs/api/paddle/static/nn/sequence_last_step_cn.rst	@rich04lin #7154
39	docs/api/paddle/static/nn/sequence_pad_cn.rst	@Echo-Nie #7153
40	docs/api/paddle/static/nn/sequence_pool_cn.rst	@Echo-Nie #7153 #7178
41	docs/api/paddle/static/nn/sequence_reshape_cn.rst	@Echo-Nie #7153
42	docs/api/paddle/static/nn/sequence_reverse_cn.rst	@Echo-Nie #7153
43	docs/api/paddle/static/nn/sequence_slice_cn.rst	@Echo-Nie #7153
44	docs/api/paddle/static/nn/sparse_embedding_cn.rst	@Echo-Nie #7153 #7177

修复完成后，文档将在官网正确渲染。参与修复的开发者将获得官网贡献者展示机会🎉。

任务认领

【报名】: 2、3、6-10

[Docathon][Fix note No.2、3、6-10]

参考资料

• 文档贡献指南
• API 文档书写规范
• Python 文档示例代码书写规范

🎯 欢迎大家积极参与，提升文档质量，共建飞桨社区！

看板信息

统计信息

排名不分先后 @Echo-Nie (13) @hanlintang (5) @cuiyu-ai (2) @HangFu7 (1) @Haroldlhl (2) @yueshehanjiang (2) @Kang-8846 (1) @rich04lin (15) @zengpufan (1) @594233 (2)