diff --git a/README.md b/README.md
deleted file mode 100644
index 3dc0fb39..00000000
--- a/README.md
+++ /dev/null
@@ -1,4 +0,0 @@
-python-magnumclient
-===================
-
-A python language binding for magnum
diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..201b3b7c
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,14 @@
+Python bindings to the Magnum API
+=================================
+
+This is a client library for Magnum built on the Magnum API. It
+provides a Python API (the ``magnumclient`` module) and a command-line
+tool (``magnum``).
+
+Development takes place via the usual OpenStack processes as outlined
+in the `developer guide
+<http://docs.openstack.org/infra/manual/developers.html>`_.
+
+* License: Apache License, Version 2.0
+* Source: http://git.openstack.org/cgit/openstack/python-magnumclient
+* Bugs: http://bugs.launchpad.net/python-magnumclient
diff --git a/setup.cfg b/setup.cfg
index 318d03fb..73f8b8f7 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -2,7 +2,7 @@
 name = python-magnumclient
 summary = Client library for Magnum API
 description-file =
-    README.md
+    README.rst
 author = OpenStack
 author-email = openstack-dev@lists.openstack.org
 home-page = http://www.openstack.org/