diff --git a/Makefile b/Makefile
index 6335de6..5c12451 100644
--- a/Makefile
+++ b/Makefile
@@ -43,10 +43,6 @@ ci-test-storage:
 install-docs:
 	pip install -Ur docs-requirements.txt
 
-docs:
-	cd docs && make html
-	sphinx-build -W -b linkcheck ./docs/ ./docs/_build/linkcheck/
-
 release-deb:
 	sh scripts/release-deb.sh debian jessie
 	sh scripts/release-deb.sh debian stretch
diff --git a/docs/contributing.rst b/docs/contributing.rst
index f4e0d5b..33a4876 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -89,9 +89,10 @@ virtualenv_ and run this inside of it::
 
 Then you can run::
 
-    pytest      # The normal testsuite
+    pytest                # The normal testsuite
     pre-commit run --all  # Run all linters (which also run via pre-commit)
-    make docs   # Build the HTML docs, output is at docs/_build/html/
+    make -C docs html     # Build the HTML docs, output is at docs/_build/html/
+    make -C docs linkcheck  # Check docs for any broken links
 
 The ``Makefile`` has a lot of options that allow you to control which tests are
 run, and which servers are tested. Take a look at its code where they are all