From 380a36974c36fc981288fd77b119e49dd63a43c9 Mon Sep 17 00:00:00 2001 From: Laurens Van Houtven <_@lvh.cc> Date: Wed, 7 Aug 2013 11:03:40 +0200 Subject: Change CONTRIBUTING to ReST, use better docstring syntax --- CONTRIBUTING.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 CONTRIBUTING.rst (limited to 'CONTRIBUTING.rst') diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst new file mode 100644 index 00000000..539da50f --- /dev/null +++ b/CONTRIBUTING.rst @@ -0,0 +1,21 @@ +This repository has a mandatory code review policy. Contributions +should happen through pull requests. Never commit to ``master`` +directly. + +When in doubt, refer to PEP 8 for Python code. + +Write docstrings like this:: + + def some_function(some_arg): + """ + Does some things. + + :param some_arg: Some argument. + """ + +So, specifically: + +- Always use three double quotes. +- Put the three double quotes on their own line. +- No blank line at the end. +- Use Sphinx parameter/attribute documentation syntax. -- cgit v1.2.3