aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAlex Gaynor <alex.gaynor@gmail.com>2013-10-01 13:30:29 -0700
committerAlex Gaynor <alex.gaynor@gmail.com>2013-10-01 13:30:29 -0700
commit166cbd3947cd4416fe7b48f1525853563cd1125f (patch)
tree0cbc161508c1438f92f340a2d11d6dd10cf5c697 /docs
parentdba9b79cf621f192e1f31ee2d88eee36184bdf05 (diff)
downloadcryptography-166cbd3947cd4416fe7b48f1525853563cd1125f.tar.gz
cryptography-166cbd3947cd4416fe7b48f1525853563cd1125f.tar.bz2
cryptography-166cbd3947cd4416fe7b48f1525853563cd1125f.zip
Reflow some paragraphs in the contributing docs
Diffstat (limited to 'docs')
-rw-r--r--docs/contributing.rst24
1 files changed, 11 insertions, 13 deletions
diff --git a/docs/contributing.rst b/docs/contributing.rst
index 8007e6b6..9dd14c23 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -77,11 +77,9 @@ Development Environment
-----------------------
Working on ``cryptography`` requires the installation of a small number of
-development dependencies.
-These are listed in ``dev-requirements.txt``
-and they can be installed in a `virtualenv`_ using `pip`_.
-Once you've installed the dependencies,
-install ``cryptography`` in ``editable`` mode. For example:
+development dependencies. These are listed in ``dev-requirements.txt`` and they
+can be installed in a `virtualenv`_ using `pip`_. Once you've installed the
+dependencies, install ``cryptography`` in ``editable`` mode. For example:
.. code-block:: sh
@@ -94,9 +92,9 @@ You are now ready to run the tests and build the documentation.
Running Tests
-------------
-``cryptography`` unit tests are found in the ``tests/`` directory.
-and are designed to be run using `pytest`_.
-`pytest`_ will discover the tests automatically, so all you have to do is:
+``cryptography`` unit tests are found in the ``tests/`` directory and are
+designed to be run using `pytest`_. `pytest`_ will discover the tests
+automatically, so all you have to do is:
.. code-block:: sh
@@ -122,14 +120,14 @@ each supported Python version and run the tests. For example:
docs: commands succeeded
pep8: commands succeeded
-You may not have all the required Python versions installed,
-in which case you will see one or more ``InterpreterNotFound`` errors.
+You may not have all the required Python versions installed, in which case you
+will see one or more ``InterpreterNotFound`` errors.
Building Documentation
----------------------
-``cryptography`` documentation is stored in the ``docs/`` directory.
-It is written in `Restructured Text`_ and rendered using `sphinx`_.
+``cryptography`` documentation is stored in the ``docs/`` directory. It is
+written in `reStructured Text`_ and rendered using `Sphinx`_.
Use `tox`_ to build the documentation. For example:
@@ -152,4 +150,4 @@ The HTML documentation index can now be found at ``docs/_build/html/index.html``
.. _`virtualenv`: https://pypi.python.org/pypi/virtualenv
.. _`pip`: https://pypi.python.org/pypi/pip
.. _`sphinx`: https://pypi.python.org/pypi/sphinx
-.. _`Restructured Text`: http://docutils.sourceforge.net/rst.html
+.. _`reStructured Text`: http://docutils.sourceforge.net/rst.html