diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..5e2dc29
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,19 @@
+===============================
+barbican_tempest_plugin
+===============================
+
+OpenStack barbican tempest 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.
+
+* Free software: Apache license
+* Documentation: http://docs.openstack.org/developer/barbican_tempest_plugin
+* Source: http://git.openstack.org/cgit/openstack/barbican_tempest_plugin
+* Bugs: http://bugs.launchpad.net/barbican
+
+Features
+--------
+
+* TODO