diff options
| author | Alex Gaynor <alex.gaynor@gmail.com> | 2013-08-07 12:05:31 -0700 |
|---|---|---|
| committer | Alex Gaynor <alex.gaynor@gmail.com> | 2013-08-07 12:05:31 -0700 |
| commit | 096b000c244d592def9bcd826528de7284d4e851 (patch) | |
| tree | 7af9d223a9929ec511c3e2ca7c0d6daa9e7587c8 | |
| parent | 42e8112e862bdb96a254dd1e6c885d0dab122464 (diff) | |
| parent | 2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4 (diff) | |
| download | cryptography-096b000c244d592def9bcd826528de7284d4e851.tar.gz cryptography-096b000c244d592def9bcd826528de7284d4e851.tar.bz2 cryptography-096b000c244d592def9bcd826528de7284d4e851.zip | |
Merge pull request #10 from hynek/linkify
CONTRIBUTING.rst: linkify, improve markup
| -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 |