diff --git a/tox.ini b/tox.ini
--- a/tox.ini
+++ b/tox.ini
@@ -49,3 +49,23 @@
   mypy
 commands =
   mypy swh
+
+[testenv:sphinx]
+whitelist_externals = make
+usedevelop = true
+extras =
+  testing-core
+  logging
+  db
+  testing-db
+  http
+deps =
+  # fetch and install swh-docs in develop mode
+  -e git+https://forge.softwareheritage.org/source/swh-docs#egg=swh.docs
+
+setenv =
+  SWH_PACKAGE_DOC_TOX_BUILD = 1
+  # turn warnings into errors
+  SPHINXOPTS = -W
+commands =
+  make -I ../.tox/sphinx/src/swh-docs/swh/ -C docs