From 2ae675d5a920047daa407fcb40ba5fc4cb4bf5e4 Mon Sep 17 00:00:00 2001 From: Hynek Schlawack Date: Wed, 7 Aug 2013 21:01:07 +0200 Subject: CONTRIBUTING.rst: linkify, improve markup --- CONTRIBUTING.rst | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) (limited to 'CONTRIBUTING.rst') 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 -- cgit v1.2.3