aboutsummaryrefslogtreecommitdiffstats
path: root/docs/development
diff options
context:
space:
mode:
authorAlex Gaynor <alex.gaynor@gmail.com>2014-06-06 21:45:24 -0700
committerAlex Gaynor <alex.gaynor@gmail.com>2014-06-06 21:45:24 -0700
commit2e0def6592f338b2886666879bcebf54a5409748 (patch)
tree5aefc1b74003c1a33d891cd92b0b9d9f51bf59d3 /docs/development
parent47089fde8fc66f600967f34e1915557a929a1681 (diff)
parent6df90fb03b8ccb642028ba927fa3490ff71d965a (diff)
downloadcryptography-2e0def6592f338b2886666879bcebf54a5409748.tar.gz
cryptography-2e0def6592f338b2886666879bcebf54a5409748.tar.bz2
cryptography-2e0def6592f338b2886666879bcebf54a5409748.zip
Merge branch 'master' into use-numbers
Diffstat (limited to 'docs/development')
-rw-r--r--docs/development/submitting-patches.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/development/submitting-patches.rst b/docs/development/submitting-patches.rst
index f1bf954b..b7f43283 100644
--- a/docs/development/submitting-patches.rst
+++ b/docs/development/submitting-patches.rst
@@ -153,7 +153,8 @@ details.
Documentation
-------------
-All features should be documented with prose in the ``docs`` section.
+All features should be documented with prose in the ``docs`` section. To ensure
+it builds and passes `doc8`_ style checks you can run ``tox -e docs``.
Because of the inherent challenges in implementing correct cryptographic
systems, we want to make our documentation point people in the right directions
@@ -201,3 +202,4 @@ So, specifically:
.. _`syntax`: http://sphinx-doc.org/domains.html#info-field-lists
.. _`Studies have shown`: http://www.ibm.com/developerworks/rational/library/11-proven-practices-for-peer-review/
.. _`our mailing list`: https://mail.python.org/mailman/listinfo/cryptography-dev
+.. _`doc8`: https://github.com/stackforge/doc8