Add instructions on building docs. Fixes #305

2 files changed, 4 insertions, 1 deletions

diff --git a/Makefile b/Makefile
index c637123..6f88b3f 100644
--- a/Makefile
+++ b/Makefile
@@ -50,7 +50,7 @@ clean-sphinx:
 
 # Build the html docs using Sphinx.
 html-sphinx:
-	cd doc && make html
+	cd doc && PYTHONPATH=.. make html
 
 .PHONY: apidocs docs-sphinx clean-sphinx html-sphinx docs
 .PHONY: check clean prerelease release
diff --git a/README.rst b/README.rst
index 68dc498..df8302d 100644
--- a/README.rst
+++ b/README.rst
@@ -16,6 +16,9 @@ If you would like to learn more about testtools, consult our documentation in
 the 'doc/' directory.  You might like to start at 'doc/overview.rst' or
 'doc/for-test-authors.rst'.
 
+To build HTML versions of the documentation, make sure you have
+sphinx installed and run ``make docs``.
+
 
 Licensing
 ---------