diff --git a/README.rst b/README.rst
index e69de29b..4313b7b5 100644
--- a/README.rst
+++ b/README.rst
@@ -0,0 +1,19 @@
+===============================
+keystoneauth
+===============================
+
+Authentication for OpenStack Clients
+
+THIS LIBRARY IS IN A PRE-RELEASE STATE. IT WILL NOT BE CONSIDERED STABLE UNTIL
+THE 1.0.0 RELEASE. FEEL FREE TO TRY IT BUT WE WILL BREAK COMPATIBILITY UNTIL
+THEN.
+
+* Free software: Apache license
+* Documentation: http://docs.openstack.org/developer/keystoneauth
+* Source: http://git.openstack.org/cgit/openstack/keystoneauth
+* Bugs: http://bugs.launchpad.net/keystoneauth
+
+Features
+--------
+
+* TODO