Lint doc files with doc8, update Contributing docs

Author: duckontheweb

doc8.ini

@@ -0,0 +1,4 @@
+[doc8]
+
+ignore-path=docs/_build,docs/tutorials
+max-line-length=88

docs/contributing.rst

@@ -45,24 +45,32 @@ More details on using ``unittest`` are `here
 Code quality checks
 ^^^^^^^^^^^^^^^^^^^
 
-PySTAC uses `flake8 <http://flake8.pycqa.org/en/latest/>`_ and `yapf
-<https://github.com/google/yapf>`_ for code formatting and style checks.
+PySTAC uses `flake8 <http://flake8.pycqa.org/en/latest/>`_ and`black
+<https://github.com/psf/black>`_ for code formatting and style checks.
 
 To run the flake8 style checks:
 
 .. code-block:: bash
 
-    > flake8 pystac
-    > flake8 tests
+    > flake8 pystac tests
 
 To format code:
 
 .. code-block:: bash
 
-   > yapf -ipr pystac
-   > yapf -ipr tests
+    > ./scripts/format
 
-You can also run the ``./scripts/test`` script to check flake8 and yapf.
+We also use `doc8 <https://github.com/pycqa/doc8>`__ for style checking on RST files in
+the docs.
+
+To check doc formatting:
+
+.. code-block:: bash
+
+    > doc8 docs
+
+You can also run the ``./scripts/test`` script to run unit tests, check code style with
+``flake8`` and ``black``, and check type annotations using ``mypy`` and ``pyright``.
 
 CHANGELOG
 ^^^^^^^^^

requirements-dev.txt

@@ -11,6 +11,7 @@ sphinx-autobuild==0.7.1
 sphinxcontrib-fulltoc==1.2.0
 nbsphinx==0.7.1
 coverage==5.2.*
+doc8==0.8.1
 
 # https://github.com/pydata/xarray/issues/5299#issuecomment-840730954
 jinja2<3.0

scripts/test

@@ -35,6 +35,12 @@ if [ "${BASH_SOURCE[0]}" = "${0}" ]; then
 
         flake8 pystac tests
 
+        echo
+        echo " -- LINTING RST FILES WITH DOC8 --"
+        echo
+
+        doc8 docs -q
+
         echo
         echo " -- CHECKING FORMAT WITH BLACK --"
         echo