PaddlePaddle发行规范

PaddlePaddle使用Trunk Based Development，使用Semantic Versioning标准表示PaddlePaddle版本号。

PaddlePaddle每次发新的版本，遵循以下流程:

需要注意的是:

发布wheel包到pypi

使用PaddlePaddle CI 完成自动化二进制编译，参考下图，选择需要发布的版本（通常包含一个CPU版本和一个GPU版本），点击"run"右侧的"..."按钮，可以弹出下面的选择框，在第二个tab (Changes)里选择需要发布的分支，这里选择0.11.0，然后点击"Run Build"按钮。
等待编译完成后可以在此页面的"Artifacts"下拉框中找到生成的3个二进制文件，分别对应CAPI，cp27m和cp27mu的版本。
由于pypi.python.org目前遵循严格的命名规范PEP 513，在使用twine上传之前，需要重命名wheel包中platform相关的后缀，比如将linux_x86_64修改成manylinux1_x86_64。
上传：

cd build/python
pip install twine
twine upload dist/[package to upload]

注：CI环境使用 https://github.com/PaddlePaddle/buildtools 这里的DockerImage作为编译环境以支持更多的Linux 发型版，如果需要手动编译，也可以使用这些镜像。这些镜像也可以从 https://hub.docker.com/r/paddlepaddle/paddle_manylinux_devel/tags/ 下载得到。
pypi不支持覆盖上传，所以一个版本号的wheel包发布之后，不可以更改。下一个wheel包需要更新版本号才可以上传。

上述PaddlePaddle CI编译wheel完成后会自动将Docker镜像push到DockerHub，所以，发布Docker镜像只需要对自动push的镜像打上版本号对应的tag即可：

docker pull [镜像]:latest
docker tag [镜像]:latest [镜像]:[version]
docker push [镜像]:[version]

需要更新的镜像tag包括：

PaddlePaddle开发过程使用Trunk Based Development 开发规范。

develop分支为开发(develop branch)版本分支。每一个develop分支的版本都经过单元测试。并且会经过模型回归测试。
release/版本号分支为每一次Release时建立的临时分支。release分支主要用于测试，bug修复和最终发版。
master分支因为历史原因，已经废弃。
其他开发者fork的feature branch。
- 建议，开发者的feature branch需要同步主版本库的develop分支。
- 建议，开发者的feature branch需要基于主版本库中的develop分支。
- 当feature branch开发完毕后，向PaddlePaddle的主版本库提交Pull Reuqest，进而进行代码评审。
  - 在评审过程中，开发者修改自己的代码，可以继续在自己的feature branch提交代码。

TODO

PaddlePaddle每次发版本首先要保证PaddlePaddle Book中所有章节功能的正确性。功能的正确性包括验证PaddlePaddle目前的paddle_trainer训练和纯使用Python训练（V2和Fluid）模型正确性。