From 8aa2d8062e7f33ad8e9bd54d229e5bdcce218b8f Mon Sep 17 00:00:00 2001
From: Chris Hoge <chris@openstack.org>
Date: Thu, 29 Jan 2015 17:01:37 -0800
Subject: [PATCH] Add details on how to run Tempest manually.

Adds details on how to actiavte the virtual environment for
running Tempest manually.

Change-Id: If1900b00305499d91771ed88309935299e598548
---
 README.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.rst b/README.rst
index da49539..2cb0cef 100644
--- a/README.rst
+++ b/README.rst
@@ -57,3 +57,17 @@ We've created an "easy button" for Ubuntu, Centos, RHEL and openSuSe.
    completed. This is saved in .tempest/.testrepository. When you use the
    'upload' command, you can also override the Refstack API server uploaded to
    with the --url option.
+
+**Tempest Hacking**
+
+By default, refstack-client installs Tempest into the `.tempest` directory.
+If you're interested in working with Tempest directly for debugging or
+configuration, you can activate a working Tempest environment by
+switching to that directory and using the installed dependencies.
+
+1. `cd .tempest`
+2. run tempest with `./run_tempest.sh -V ` or `source ./.venv/bin/activate`
+   and run tests manually with `testr`.
+
+This will make the entire Tempest environment available for you to run,
+including the `run_tempest` script and `testr`.