diff options
author | Hynek Schlawack <schlawack@variomedia.de> | 2013-08-07 21:01:07 +0200 |
---|---|---|
committer | Hynek Schlawack <schlawack@variomedia.de> | 2013-08-07 21:01:07 +0200 |
commit | 2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4 (patch) | |
tree | f2f61e8fa0cf9be5566b69decdddd5a1e323cd04 /CONTRIBUTING.rst | |
parent | fc6dc877d67579fc86a93f12798da3530b4c2d65 (diff) | |
download | cryptography-2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4.tar.gz cryptography-2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4.tar.bz2 cryptography-2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4.zip |
CONTRIBUTING.rst: linkify, improve markup
Diffstat (limited to 'CONTRIBUTING.rst')
-rw-r--r-- | CONTRIBUTING.rst | 21 |
1 files changed, 18 insertions, 3 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 539da50f..ff1a619c 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -1,10 +1,21 @@ +Process +======= + 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. +Code +==== + +When in doubt, refer to `PEP 8`_ for Python code. + +Docs +==== -Write docstrings like this:: +Write docstrings like this: + +.. code-block:: python def some_function(some_arg): """ @@ -18,4 +29,8 @@ 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. +- Use Sphinx parameter/attribute documentation `syntax`_. + + +.. _`PEP 8`: http://www.peps.io/8/ +.. _`syntax`: http://sphinx-doc.org/domains.html#info-field-lists |