🚑 Make Sphinx nitpicky about broken references

Fixes #2424

2 files changed, 14 insertions, 1 deletions

diff --git a/docs/conf.py b/docs/conf.py
index d5111391..1928af58 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -146,3 +146,7 @@ link_files = {
         ],
     ),
 }
+
+
+# Be strict about any broken references:
+nitpicky = True
diff --git a/tox.ini b/tox.ini
index 535b67d3..828d2c02 100644
--- a/tox.ini
+++ b/tox.ini
@@ -49,7 +49,16 @@ extras =
         testing
 changedir = docs
 commands =
-        python -m sphinx . {toxinidir}/build/html
+        {envpython} -m sphinx \
+          -j auto \
+          -b html \
+          --color \
+          -a \
+          -n \
+          -W \
+          -d "{temp_dir}/.doctrees" \
+          . \
+          "{toxinidir}/build/html"
 
 [testenv:finalize]
 skip_install = True