diff --git a/README.rst b/README.rst
index 467c08d4b0..4b4de03af8 100644
--- a/README.rst
+++ b/README.rst
@@ -28,7 +28,7 @@ Docs
 ----
 
 To build documentation install sphinx (``pip install sphinx``), run
-``python setup.py build_sphinx``, and then browse to
+``sphinx-build -W -b html doc/source doc/build/html``, and then browse to
 /doc/build/html/index.html. These docs are auto-generated after every
 commit and available online at
 https://docs.openstack.org/swift/latest/.