diff --git a/README.md b/README.md
index b4c69465f7..213ef135c1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
+Puppet Modules
+==============
+
 These are a set of puppet manifests and modules that are currently being
 used to manage the OpenStack Project infrastructure.
 
@@ -10,3 +13,12 @@ These puppet modules require puppet 2.7 or greater. Additionally, the
 site.pp manifest assumes the existence of hiera.
 
 See http://ci.openstack.org for more information.
+
+Documentation
+==============
+
+The documentation presented at http://ci.openstack.org comes from
+git://git.openstack.org/openstack-infra/config repo's docs/source.  To
+build the documentation use
+
+ $ tox -evenv python setup.py build_sphinx