diff --git a/ironic_tempest_plugin/README.rst b/ironic_tempest_plugin/README.rst
new file mode 100644
index 0000000..a7fcc92
--- /dev/null
+++ b/ironic_tempest_plugin/README.rst
@@ -0,0 +1,22 @@
+=====================
+Ironic tempest plugin
+=====================
+
+This directory contains Tempest tests to cover the Ironic project,
+as well as a plugin to automatically load these tests into tempest.
+
+See the tempest plugin docs for information on using it:
+http://docs.openstack.org/developer/tempest/plugin.html#using-plugins
+
+To run all tests from this plugin, install ironic into your environment
+and run::
+
+    $ tox -e all-plugin -- ironic
+
+To run a single test case, run with the test case name, for example::
+
+    $ tox -e all-plugin -- ironic_tempest_plugin.tests.scenario.test_baremetal_basic_ops.BaremetalBasicOps.test_baremetal_server_ops
+
+To run all tempest tests including this plugin, run::
+
+    $ tox -e all-plugin