From 813b294031ab365073d475f5d11e866114726e69 Mon Sep 17 00:00:00 2001 From: Paul Kehrer Date: Thu, 5 Jun 2014 12:40:56 -0500 Subject: add information about building docs to getting started --- docs/development/submitting-patches.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'docs/development/submitting-patches.rst') 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 -- cgit v1.2.3