diff --git a/README.rst b/README.rst
index 45938fe..5687464 100644
--- a/README.rst
+++ b/README.rst
@@ -1,12 +1,19 @@
-===============================
+========================
+Team and repository tags
+========================
+
+.. image:: http://governance.openstack.org/tc/badges/murano-tempest-plugin.svg
+    :target: http://governance.openstack.org/tc/reference/tags/index.html
+
+=====================
 murano-tempest-plugin
-===============================
+=====================
 
-Tempest plugin for the murano project.
+This directory contains Tempest tests to cover the Murano project, as well
+as a plugin to automatically load these tests into tempest.
 
-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.
+See the Tempest plugin docs for information on using it:
+https://docs.openstack.org/tempest/latest/#using-plugins
 
 * Free software: Apache license
 * Documentation: http://docs.openstack.org/developer/murano-tempest-plugin
@@ -14,7 +21,18 @@ Note that this is a hard requirement.
 * Source: http://git.openstack.org/cgit/openstack/murano-tempest-plugin
 * Bugs: http://bugs.launchpad.net/murano
 
-Features
---------
+Running the tests
+-----------------
 
-* TODO
+To run all tests from this plugin, install Murano into your environment and
+navigate to tempest directory::
+
+    $ cd /opt/stack/tempest
+
+Run this command::
+
+    $ tox -e all-plugin -- application_catalog 
+
+To run a single test case, run with the test case name, for example::
+
+    $ tox -e all-plugin -- murano_tempest_tests.tests.api.application_catalog.test_categories.TestCategories.test_list_categories