add README

Change-Id: I7e2ca13aa4942c85bf57070db3d09dd14cc0266e
Closes-Bug: 1333948

1 files changed, 20 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index e69de29..308de85 100644
--- a/README.rst
+++ b/README.rst
@@ -0,0 +1,20 @@
+Middleware for the OpenStack Identity API (Keystone)
+====================================================
+
+This package contains middleware modules designed to provide authentication and
+authorization features to web services other than `Keystone
+<https://github.com/openstack/keystone>`. The most prominent module is
+``keystonemiddleware.auth_token``. This package does not expose any CLI or
+Python API features.
+
+The source is available on GitHub at:
+
+    http://github.com/openstack/keystonemiddleware
+
+Bugs and feature requests are tracked on Launchpad at:
+
+    https://bugs.launchpad.net/keystonemiddleware
+
+For any other information, refer to the parent project, Keystone:
+
+    https://github.com/openstack/keystone