From 82465b907d5131a57862a7242d64d610c3a05039 Mon Sep 17 00:00:00 2001
From: "Jason R. Coombs" <jaraco@jaraco.com>
Date: Sat, 17 Dec 2022 20:46:15 -0500
Subject: [PATCH] Build docs in CI, including sphinx-lint.

---
 .github/workflows/main.yml | 17 +++++++++++++++++
 setup.cfg                  |  1 +
 tox.ini                    |  1 +
 3 files changed, 19 insertions(+)

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 9d02856b..9629a26a 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -72,11 +72,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
 
diff --git a/setup.cfg b/setup.cfg
index a8f80ced..c062c7b9 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -52,6 +52,7 @@ docs =
 	jaraco.packaging >= 9
 	rst.linker >= 1.9
 	furo
+	sphinx-lint
 
 	# local
 
diff --git a/tox.ini b/tox.ini
index 3ca2af38..42ae6852 100644
--- a/tox.ini
+++ b/tox.ini
@@ -20,6 +20,7 @@ extras =
 changedir = docs
 commands =
 	python -m sphinx -W --keep-going . {toxinidir}/build/html
+	python -m sphinxlint
 
 [testenv:release]
 skip_install = True