From ecb271b23b3007ee256909fbfd013a2904cf90c1 Mon Sep 17 00:00:00 2001 From: Jeff Wang Date: Thu, 30 Aug 2018 17:41:56 -0700 Subject: [PATCH] Create README.md --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..eb0c3b65d --- /dev/null +++ b/README.md @@ -0,0 +1,19 @@ +# Introduction +Fluiddoc consolidates all the documentations related to Paddle. It supplies the contents to PaddlePaddle.org via CI. + +# Architecture +FluidDoc submodules Paddle, Book, Models, Mobile and Anakin under `external` folder. All submodules should be put under `external` as standard practice. + +Fluiddoc then uses them as references to load up the documents. The FluidDoc constructs the whole doc-tree under the `FluidDoc/doc/fluid` folder. The entry point is `FluidDoc/doc/fluid/index_cn.rst` and `FluidDoc/doc/fluid/index_en.rst` + +When a release branch is pushed to Github, Travis-CI will start automatically to compile documents and deploy documents to the server. + +## Note: +FluidDoc needs Paddle python module to compile API documents. Unfortunately, compiling Paddle python module takes longer time Travis CI permits. Usually Travis CI will fail due because of timeout. That's why there three jobs on Travis, two of them are to build libraries. Once the libraries are cached on the Travis, next build will be a lot faster. + +# Publish New release +1. Checkout a new release branch. The branch name should follow `release/` +1. Update the documentations on the submodules or within FluidDoc +1. Update the submodules under `external` folder and commit the changes. +1. Git push the branch to Github, Travis CI will start several builds to publish the documents + -- GitLab