diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..6835058e
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,9 @@
+OpenStack Ansible
+#################
+
+A repository for developing the openstack-ansible ironic role, to plug into the `openstack-ansible repository`_
+
+Please see the `role-ironic spec`_ for more details.
+
+.. _openstack-ansible repository: https://github.com/openstack/openstack-ansible
+.. _role-ironic spec: https://github.com/openstack/openstack-ansible-specs/blob/master/specs/mitaka/role-ironic.rst