diff options
-rw-r--r-- | CONTRIBUTING | 7 | ||||
-rw-r--r-- | CONTRIBUTING.rst | 21 |
2 files changed, 21 insertions, 7 deletions
diff --git a/CONTRIBUTING b/CONTRIBUTING deleted file mode 100644 index 3e47ec65..00000000 --- a/CONTRIBUTING +++ /dev/null @@ -1,7 +0,0 @@ -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. - -Use PEP 257 for docstring conventions, except use Sphinx notation for -arguments, attributes, et cetera. 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. |