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

.github/workflows/main.yml

@@ -80,11 +80,28 @@ jobs:
       - name: Run tests
         run: tox
 
+  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:
     - test
+    - docs
 
     runs-on: ubuntu-latest
 

setup.cfg

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

tox.ini

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