diff options
author | Laurens Van Houtven <_@lvh.cc> | 2013-08-07 11:03:40 +0200 |
---|---|---|
committer | Laurens Van Houtven <_@lvh.cc> | 2013-08-07 11:03:40 +0200 |
commit | 380a36974c36fc981288fd77b119e49dd63a43c9 (patch) | |
tree | b1898d0e9fd67780052fe2abd448ead3a917c093 | |
parent | 86d5db8d3619be5a2dbb8c354a5bb861295dfd32 (diff) | |
download | cryptography-380a36974c36fc981288fd77b119e49dd63a43c9.tar.gz cryptography-380a36974c36fc981288fd77b119e49dd63a43c9.tar.bz2 cryptography-380a36974c36fc981288fd77b119e49dd63a43c9.zip |
Change CONTRIBUTING to ReST, use better docstring syntax
-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. |