diff --git a/README b/README
index ac8681ae07..58968ae16b 100644
--- a/README
+++ b/README
@@ -4,7 +4,7 @@ Swift
 A distributed object store that was originally developed as the basis for 
 Rackspace's Cloud Files.
 
-To build documentation run `make html` in the /doc folder, and then browse to
+To build documentation run `python setup.py build_sphinx`, and then browse to
 /doc/build/html/index.html.
 
 The best place to get started is the "SAIO - Swift All In One", which will walk
diff --git a/doc/source/development_saio.rst b/doc/source/development_saio.rst
index ef5ee9cbfc..2827fa523c 100644
--- a/doc/source/development_saio.rst
+++ b/doc/source/development_saio.rst
@@ -152,7 +152,7 @@ good idea what to do on other environments.
      `bzr launchpad-login <launchpad_id>`
   #. Check out your bzr repo of swift, for example:
      `bzr branch lp:~swift-core/swift/trunk swift`
-  #. `cd ~<your-user-name>/swift; python setup.py develop`
+  #. `cd ~<your-user-name>/swift; sudo python setup.py develop`
   #. Edit `~/.bashrc` and add to the end::
 
         export PATH_TO_TEST_XFS=/mnt/sdb1/test