index_cn.rst 1.2 KB
Newer Older
L
Luo Tao 已提交
1 2
开发标准
========
D
dongzhihong 已提交
3
PaddlePaddle遵守如下三个部分的代码和文档规范。
D
"fixed"  
dongzhihong 已提交
4

D
dongzhihong 已提交
5
PaddlePaddle使用git做版本管理,docker作为构建和测试环境。代码中包含了Cuda, C++, Python, Shell等多种编程语言。语言规范遵守Google C++ Style, Pep-8, 代码库中包含自动化检查工具做风格检查。代码注释需要遵守Doxygen规范,不满足风格要求的代码会编译失败。关于如何使用git, 构建测试及代码开发, 我们提供了如下指南。
D
dongzhihong 已提交
6

D
"fixed"  
dongzhihong 已提交
7 8
..  toctree::
  :maxdepth: 1
D
dongzhihong 已提交
9

D
"fixed"  
dongzhihong 已提交
10
  contribute_to_paddle_cn.md
L
Luo Tao 已提交
11

D
dongzhihong 已提交
12
PaddlePaddle面向国内外用户,包含了中文和英文两部分的文档。设计文档和issue问题描述都推荐使用英文。对于设计文档,重在问题描述,背景阐述,然后才是解决方案。文档由Sphinx生成,因此代码注释也需要符合Sphinx文档标准。推荐本地使用paddlepaddle.org工具编译生成和预览文档,请参阅如下文档。
D
dongzhihong 已提交
13

L
Luo Tao 已提交
14 15 16 17
..  toctree::
  :maxdepth: 1

  write_docs_cn.rst
D
"fixed"  
dongzhihong 已提交
18

D
dongzhihong 已提交
19
PaddlePaddle V2 使用新增Layer方式定义新的操作。组合基础API可以实现多种复杂Layer, 满足绝大多数应用。如需要定制Layer,请参阅如下文档,欢迎提交patch。
D
"fixed"  
dongzhihong 已提交
20 21 22 23

..  toctree::
  :maxdepth: 1

L
Luo Tao 已提交
24
  new_layer_cn.rst