diff --git a/doc/source/installing.rst b/doc/source/installing.rst
index 9d30d6685c..9c363ffb56 100644
--- a/doc/source/installing.rst
+++ b/doc/source/installing.rst
@@ -49,7 +49,14 @@ Install the Keystone web service:
 
 .. code-block:: bash
 
-    $ python setup.py install
+    $ pip install .
+
+.. NOTE::
+
+    This step is guaranteed to fail if you do not have the proper binary
+    dependencies already installed on your development system. Maintaining a
+    list of platform-specific dependencies is outside the scope of this
+    documentation, but is within scope of `DevStack <http://devstack.org/>`_.
 
 You should have all the pieces you need to run Keystone installed on your
 system. The following commands should be available on the command-line path: