diff --git a/Makefile b/Makefile
index 030d5c65812..204a156bb69 100644
--- a/Makefile
+++ b/Makefile
@@ -58,7 +58,7 @@ $(TEMPLATE_MACROS) : boot/cabal_macros.template.h cabal-dev-scripts/src/GenCabal
 
 # generated docs
 
-doc/buildinfo-fields-reference.rst : phony
+buildinfo-fields-reference : phony
 	cabal build --builddir=dist-newstyle-bi --project-file=cabal.project.buildinfo buildinfo-reference-generator
 	$$(cabal-plan list-bin --builddir=dist-newstyle-bi buildinfo-reference-generator) buildinfo-reference-generator/template.zinza | tee $@
 
@@ -241,8 +241,6 @@ $(USERGUIDE_STAMP) : doc/*.rst
 	mkdir -p $(SPHINX_HTML_OUTDIR)
 	(. ./.python-sphinx-virtualenv/bin/activate && pip install -r doc/requirements.txt && $(SPHINXCMD) doc $(SPHINX_HTML_OUTDIR))
 
-docs: haddock users-guide
-
 .python-sphinx-virtualenv:
 	python3 -m venv .python-sphinx-virtualenv
 	(. ./.python-sphinx-virtualenv/bin/activate)
diff --git a/doc/README.md b/doc/README.md
index 8f1169d379d..5390de1374b 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -12,8 +12,7 @@ http://cabal.readthedocs.io/
 ### How to build it
 
 Building the documentation requires Python 3 be installed
-* `> cd Cabal`
-* `> make clean users-guide`
+* `> make users-guide`
 * Python on Mac OS X dislikes `LC_CTYPE=UTF-8`, unset the env var in
 terminal preferences and instead set `LC_ALL=en_US.UTF-8` or something