diff --git a/README.rst b/README.rst
index 746cda0c1..bb280c89a 100644
--- a/README.rst
+++ b/README.rst
@@ -9,7 +9,7 @@ similarly configured jobs is easy.
 
 To install::
 
-    $ sudo python setup.py install
+    $ pip install --user jenkins-job-builder
 
 Online documentation:
 
@@ -29,6 +29,13 @@ Cloning::
 
     git clone https://git.openstack.org/openstack-infra/jenkins-job-builder
 
+A virtual environment is recommended for development.  For example, Jenkins
+Job Builder may be installed from the top level directory::
+
+    $ virtualenv .venv
+    $ source .venv/bin/activate
+    $ pip install -r test-requirements.txt -e .
+
 Patches are submitted via Gerrit at:
 
 * https://review.openstack.org/
diff --git a/doc/source/installation.rst b/doc/source/installation.rst
index aeb911905..9187451eb 100644
--- a/doc/source/installation.rst
+++ b/doc/source/installation.rst
@@ -3,7 +3,14 @@ Installation
 
 To install Jenkins Job Builder from source, run::
 
-  sudo python setup.py install
+  pip install --user jenkins-job-builder
+
+A virtual environment is recommended for development.  For example, Jenkins
+Job Builder may be installed from the top level directory::
+
+    $ virtualenv .venv
+    $ source .venv/bin/activate
+    $ pip install -r test-requirements.txt -e .
 
 Alternatively, the current release can be installed from pypi::