背景

为了使中、英文 API 文档的示例代码保持一致，飞桨中文 API 文档使用 COPY-FROM 来直接引用英文的 API 示例代码。
但是，目前中文 API 文档中还存在一些 COPY-FROM 不成功的情况，表现形式为无法显示代码示例，例如 Conll05st

原因分析

一般无法正确显示代码示例，会分为 2 种情况：中文文档的 COPY-FROM 引用方式写法存在错误，或者是被引用的英文文档的示例代码写法存在错误。

1. COPY-FROM 后面的 API 名称或路径不正确。

以 Conll05st 为例，COPY-FROM 后面的路径为 paddle.text.datasets.Conll05st，但实际的 API 路径为 paddle.text.Conll05st（可以直接看官网左侧 API 的目录来确定路径）

2. 被 COPY-FROM 的 API 没有规范的书写格式

典型场景为英文文档的示例代码缺少空行，如

• :name: code_id 标识符之后没有空行，以 distributed.Fleet 为例。

• .. code-block:: python 之后没有空行 （在不需要 name: code_id 标识符时）
  

  docs/docs/api/paddle/distributed/fleet/Fleet_cn.rst

  Lines 683 to 688 in f311fe4

  	**代码示例**
  	.. code-block:: python
  	# 这个示例需要由 fleetrun 启动，用法为：
  	# fleetrun --gpus=0,1 example.py
  	# 脚本 example.py 中的代码是下面这个示例。

任务描述

序号	中文文档链接	认领人/状态/PR
1	Event_cn	@entired #6308 #6326 #6381
2	Conll05st_cn	@entired #6308 #6326 #6381 @Liyulingyue #6304
3	Stream_cn	@entired #6308 #6326 #6381
4	Imikolov_cn	@Sekiro-x #6309
5	Imdb_cn	@Sekiro-x #6309
6	UCIHousing_cn	@Kaedeharai #6311
7	InMemoryDataset_cn	@Kaedeharai #6311
8	WMT16_cn	@Kaedeharai #6311
9	Movielens_cn	@Kaedeharai #6311
10	WMT14_cn	@Kaedeharai #6311
11	Fleet_cn	@Turingg #6310 #6349
12	Adadelta_cn	@Turingg #6310 #6349
13	AdamW_cn	@Turingg #6310 #6349
14	Adam_cn	@Turingg #6310 #6349
15	Adamax_cn	@Turingg #6310 #6349
16	Lamb_cn	@entired #6327 #6379
17	Optimizer_cn	@entired #6327 #6379
18	RMSProp_cn	@entired #6327 #6379
19	DistributedStrategy_cn	@entired #6327 #6379

任务认领

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

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

看板信息

统计信息

排名不分先后 @entired (7) @Sekiro-x (2) @Kaedeharai (5) @Turingg (5)