aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorPaul Kehrer <paul.l.kehrer@gmail.com>2014-02-05 17:41:41 -0600
committerPaul Kehrer <paul.l.kehrer@gmail.com>2014-02-05 17:41:41 -0600
commit387424bfab02aa929127201945a5a9476abb8be6 (patch)
tree02fcbc27786ea55aa7d0556d236e1061354831c6 /docs
parentf970eaa676eb0cd89cdb2389f03d365899812822 (diff)
parenta54dcde3bda3f2de83b56d4456903e7bdce182e6 (diff)
downloadcryptography-387424bfab02aa929127201945a5a9476abb8be6.tar.gz
cryptography-387424bfab02aa929127201945a5a9476abb8be6.tar.bz2
cryptography-387424bfab02aa929127201945a5a9476abb8be6.zip
Merge pull request #566 from alex/comment-cleanup
Write comments as complete sentences
Diffstat (limited to 'docs')
-rw-r--r--docs/contributing.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/docs/contributing.rst b/docs/contributing.rst
index 74b854bd..7f4c77f4 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -43,6 +43,8 @@ Code
When in doubt, refer to :pep:`8` for Python code.
+`Write comments as complete sentences.`_
+
Every code file must start with the boilerplate notice of the Apache License.
Additionally, every Python code file must contain
@@ -287,6 +289,7 @@ The HTML documentation index can now be found at
.. _`GitHub`: https://github.com/pyca/cryptography
.. _`our mailing list`: https://mail.python.org/mailman/listinfo/cryptography-dev
+.. _`Write comments as complete sentences.`: http://nedbatchelder.com/blog/201401/comments_should_be_sentences.html
.. _`syntax`: http://sphinx-doc.org/domains.html#info-field-lists
.. _`pytest`: https://pypi.python.org/pypi/pytest
.. _`tox`: https://pypi.python.org/pypi/tox