diff --git a/README.rst b/README.rst
index d1d06a5..ce445fe 100644
--- a/README.rst
+++ b/README.rst
@@ -7,22 +7,42 @@
 
 .. Change things from this point on
 
-======================
-octavia-tempest-plugin
-======================
-
-Tempest plugin for Octavia
+==============================
+Tempest integration of Octavia
+==============================
 
 This project contains the Tempest plugin for the Octavia project for
 OpenStack Load Balancing.
 
 For more information about Octavia see:
-https://docs.openstack.org/developer/octavia/
+https://docs.openstack.org/octavia/latest/
 
 For more information about Tempest plugins see:
-http://docs.openstack.org/developer/tempest/plugin.html
+https://docs.openstack.org/tempest/latest/plugin.html
 
 * Free software: Apache license
-* Documentation: http://docs.openstack.org/developer/octavia-tempest-plugin
+* Documentation: http://docs.openstack.org/octavia-tempest-plugin/latest
 * Source: http://git.openstack.org/cgit/openstack/octavia-tempest-plugin
-* Bugs: http://bugs.launchpad.net/octavia
+* Bugs: https://storyboard.openstack.org/#!/project/910
+
+Installing
+----------
+
+Clone this repository to the destination machine, and call from the repo::
+
+    $ pip install -e .
+
+Running the tests
+-----------------
+
+To run all the tests from this plugin, call from the tempest repo::
+
+    $ tox -e all-plugin -- octavia_tempest_plugin
+
+To run a single test case, call with full path, for example::
+
+    $ tox -e all-plugin -- octavia_tempest_plugin.tests.v2.scenario.test_basic_ops.BasicOpsTest.test_basic_ops
+
+To retrieve a list of all tempest tests, run::
+
+    $ testr list-tests