Updated configuration files.

Author: domdfcoding

CONTRIBUTING.rst

@@ -19,7 +19,7 @@ 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 via ``pre-commit``:
+``yapf`` and ``isort`` can be run manually via ``pre-commit``:
 
 .. code-block:: bash
 
@@ -65,7 +65,7 @@ Type annotations are checked using ``mypy``. Run ``mypy`` using ``tox``:
 Build documentation locally
 ------------------------------
 
-Documentation is powered by Sphinx. A local copy of the documentation can be built with ``tox``:
+The documentation is powered by Sphinx. A local copy of the documentation can be built with ``tox``:
 
 .. code-block:: bash
 

doc-source/Building.rst

@@ -1,8 +1,8 @@
-*******************************
+=========================
 Downloading source code
-*******************************
+=========================
 
-The ``domdf_python_tools`` source code resides on publicly accessible GitHub servers,
+The ``domdf_python_tools`` source code is available on GitHub,
 and can be accessed from the following URL: https://github.com/domdfcoding/domdf_python_tools"
 
 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 ``domdf_python_tools`` 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

@@ -1,12 +1,13 @@
 /* This file is managed by 'repo_helper'. Don't edit it directly. */
 
-/* Body width */
-.wy-nav-content {max-width: 1200px !important;}
+.wy-nav-content {
+	max-width: 1200px !important;
+}
 
-/* Spacing between list items */
-li p:last-child { margin-bottom: 12px !important;}
+li p:last-child {
+	margin-bottom: 12px !important;
+}
 
-/* Smooth scrolling between sections */
 html {
-  scroll-behavior: smooth;
+	scroll-behavior: smooth;
 }

doc-source/_static/style.css

@@ -19,7 +19,7 @@ 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 via ``pre-commit``:
+``yapf`` and ``isort`` can be run manually via ``pre-commit``:
 
 .. prompt:: bash
 
@@ -65,7 +65,7 @@ Type annotations are checked using ``mypy``. Run ``mypy`` using ``tox``:
 Build documentation locally
 ------------------------------
 
-Documentation is powered by Sphinx. A local copy of the documentation can be built with ``tox``:
+The documentation is powered by Sphinx. A local copy of the documentation can be built with ``tox``:
 
 .. prompt:: bash
 

doc-source/contributing.rst

@@ -165,8 +165,8 @@ Installation
 	:maxdepth: 3
 	:caption: Documentation
 
+	contributing
 	Source
-	Building
 
 .. start links
 

doc-source/index.rst

@@ -1,6 +1,6 @@
 #!/usr/bin/python3
 
-# This file is managed by `repo_helper`. Don't edit it directly
+# This file is managed by `repo_helper`. Don't edit it directly.
 
 # stdlib
 import platform

make_conda_recipe.py

@@ -25,6 +25,7 @@ python =
 
 
 [testenv]
+setenv = PYTHONDEVMODE = 1
 # Install test requirements
 deps = -r{toxinidir}/tests/requirements.txt
 commands =
@@ -191,8 +192,7 @@ namespace_packages = True
 
 
 [coverage:run]
-plugins =
-	coverage_pyver_pragma
+plugins = coverage_pyver_pragma
 
 
 [check-wheel-contents]