1 files changed, 24 insertions, 12 deletions

diff --git a/README.rst b/README.rst
index 960bc5c..abab058 100644
--- a/README.rst
+++ b/README.rst
@@ -1,19 +1,31 @@
-===============================
+=====
 ttrun
-===============================
+=====
 
 Simple CLI to run testtools tests
 
-Please fill here a long description which must be at least 3 lines wrapped on
-80 cols, so that distribution package maintainers can use it in their packages.
-Note that this is a hard requirement.
+In a testrepository based workflow, sometimes you want/need to run individual
+tests outside of the construct of testtools. Additionally, someitmes you want
+to use a pre-existing tox virtualenv to do so. Or, at least, I do.
 
-* Free software: Apache license
-* Documentation: http://docs.openstack.org/developer/ttrun
-* Source: http://git.openstack.org/cgit/openstack/ttrun
-* Bugs: http://bugs.launchpad.net/ttrun
+Typing:
+::
 
-Features
---------
+  .tox/py27/bin/python -m testtools.run some.test
 
-* TODO
+Got boring. So this is a simple wrapper.
+
+It has two modes:
+::
+
+  ttrun some.test
+
+Will run that test with the system python.
+
+If you want to re-use a tox virtualenv:
+::
+  ttrun -epy27 some.test
+
+Will run some.test in the given tox venv.
+
+Both modes can be run with no parameters to have testtools run all the tests.