diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..101f4330 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,30 @@ +# How to contribute + +## Ways to improve the documents + +* Submit a issue + + If you find errors in documents or want to improve, this is the easiest way to help. + You can put your document in any format in the issue comments, then a core developer + will format it with reStructureText syntax and commit it into the repo. + +* Send a pull request + + This way is for those who are familar with + [Git workflow](https://guides.github.com/introduction/flow/) and the + [reStructureText](http://www.sphinx-doc.org/en/stable/rest.html). + A PR is needed to be reviewed by at least one person before merging. + +## Document format + +* Chinese writing guideline + + Follow section 3 in https://mirrors.ustc.edu.cn/anthon/aosc-l10n/zh_CN_l10n.pdf + +* reStructureText syntax + + Make sure `sphinx-build` run without warnings. + +## Credit + +For those improved the documnets, the Github username will be mentioned in the document.