Merge https://github.com/jaraco/skeleton

# Conflicts:
#	.github/workflows/main.yml

Author: jaraco

.github/workflows/main.yml

@@ -111,12 +111,29 @@ jobs:
             VM-${{ matrix.platform }},
             Py-${{ steps.python-install.outputs.python-version }}
 
+  docs:
+    runs-on: ubuntu-latest
+    env:
+      TOXENV: docs
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python }}${{ matrix.dev }}
+      - name: Install tox
+        run: |
+          python -m pip install tox
+      - name: Run tests
+        run: tox
+
   check:  # This job does nothing and is only used for the branch protection
     if: always()
 
     needs:
     - integration-test
     - test
+    - docs
     - test_cygwin
 
     runs-on: ubuntu-latest

setup.cfg

@@ -93,6 +93,7 @@ docs =
 	jaraco.packaging >= 9
 	rst.linker >= 1.9
 	furo
+	sphinx-lint
 
 	# tidelift
 	jaraco.tidelift >= 1.4

tox.ini

@@ -40,6 +40,7 @@ extras =
 changedir = docs
 commands =
 	python -m sphinx -W --keep-going . {toxinidir}/build/html
+	python -m sphinxlint
 
 [testenv:finalize]
 skip_install = True