Updated docs.

Author: domdfcoding

doc-source/Building.rst

@@ -1,8 +1,8 @@
-*******************************
+=========================
 Downloading source code
-*******************************
+=========================
 
-The ``coverage_pyver_pragma`` source code resides on publicly accessible GitHub servers,
+The ``coverage_pyver_pragma`` source code is available on GitHub,
 and can be accessed from the following URL: https://github.com/domdfcoding/coverage_pyver_pragma"
 
 If you have ``git`` installed, you can clone the repository with the following command:
@@ -25,3 +25,17 @@ If you have ``git`` installed, you can clone the repository with the following c
     :alt: Downloading a 'zip' file of the source code.
 
     Downloading a 'zip' file of the source code
+
+
+Building from source
+-----------------------
+
+The recommended way to build ``coverage_pyver_pragma`` is to use `tox <https://tox.readthedocs.io/en/latest/>`_:
+
+.. prompt:: bash
+
+	tox -e build
+
+The source and wheel distributions will be in the directory ``dist``.
+
+If you wish, you may also use `pep517.build <https://pypi.org/project/pep517/>`_ or another :pep:`517`-compatible build tool.

doc-source/Source.rst

@@ -0,0 +1,72 @@
+.. This file based on https://github.com/PyGithub/PyGithub/blob/master/CONTRIBUTING.md
+
+==============
+Contributing
+==============
+
+``coverage_pyver_pragma`` uses `tox <https://tox.readthedocs.io>`_ to automate testing and packaging, and `pre-commit <https://pre-commit.com>`_ to maintain code quality.
+
+Install ``pre-commit`` with ``pip`` and install the git hook:
+
+.. prompt:: bash
+
+	python -m pip install pre-commit
+	pre-commit install
+
+
+Coding style
+--------------
+
+`Yapf <https://github.com/google/yapf>`_ is used for code formatting, and `isort <https://timothycrosley.github.io/isort/>`_ is used to sort imports.
+
+``yapf`` and ``isort`` can be run manually via ``pre-commit``:
+
+.. prompt:: bash
+
+	pre-commit run yapf -a
+	pre-commit run isort -a
+
+
+The complete autoformatting suite can be run with ``pre-commit``:
+
+.. prompt:: bash
+
+	pre-commit run -a
+
+
+Automated tests
+-------------------
+
+Tests are run with ``tox`` and ``pytest``. To run tests for a specific Python version, such as Python 3.6, run:
+
+.. prompt:: bash
+
+	tox -e py36
+
+
+To run tests for all Python versions, simply run:
+
+.. prompt:: bash
+
+	tox
+
+
+Type Annotations
+-------------------
+
+Type annotations are checked using ``mypy``. Run ``mypy`` using ``tox``:
+
+.. prompt:: bash
+
+	tox -e mypy
+
+
+
+Build documentation locally
+------------------------------
+
+The documentation is powered by Sphinx. A local copy of the documentation can be built with ``tox``:
+
+.. prompt:: bash
+
+	tox -e docs

doc-source/contributing.rst

@@ -154,8 +154,8 @@ Installation
 
 	usage
 	API Reference<docs>
+	contributing
 	Source
-	Building
 
 .. start links