diff --git a/README.md b/README.md
deleted file mode 100644
index cbcb576..0000000
--- a/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-openstack-resource-agents
-=========================
-
-Pacemaker High Availability resource agents for OpenStack
\ No newline at end of file
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..dd469ee
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,42 @@
+Pacemaker High Availability resource agents for OpenStack
+=========================================================
+
+This repository contains a collection of Pacemaker_ `resource agents`_
+(RAs) which can be used to provide highly available OpenStack services
+managed within Pacemaker_ clusters.
+
+.. _Pacemaker: http://clusterlabs.org/
+.. _resource agents: http://www.linux-ha.org/wiki/Resource_agents
+
+Usage
+-----
+
+Please see the `OpenStack High Availability Guide`__ for usage
+instructions.  It is a bit out of date, but most of the information is
+still accurate; hopefully we can update it soon.
+
+__ http://docs.openstack.org/high-availability-guide/content/
+
+Development
+-----------
+
+Bugs can be viewed and reported via
+<https://launchpad.net/openstack-resource-agents>.
+
+Suggestions for improvements are very welcome; changes can be
+submitted for review via `the normal OpenStack development process`__.
+
+__ http://docs.openstack.org/infra/manual/developers.html
+
+History
+-------
+
+Martin Loschwitz started this repository in 2012, hosted at
+<https://github.com/madkiss/openstack-resource-agents>,
+and together with Sébastien Han and Emilien Macchi contributed
+the majority of resource agents.
+
+Martin eventually stepped down from maintainership, and
+`in October 2015 the project was moved to StackForge`__.
+
+__ http://lists.openstack.org/pipermail/openstack-dev/2015-October/077601.html