diff --git a/hooks/keystone-hooks b/hooks/keystone-hooks
index e50c5537..253a4979 100755
--- a/hooks/keystone-hooks
+++ b/hooks/keystone-hooks
@@ -41,6 +41,7 @@ def install_hook():
     # to add databsae sync
     execute("rm -rf /var/lib/keystone/keystone.db")
     execute("keystone-manage database sync")
+    execute("sleep 10")
     execute("service keystone start", echo=True)
     ensure_initial_admin(config)
 
diff --git a/readme b/readme
new file mode 100644
index 00000000..8c14c93f
--- /dev/null
+++ b/readme
@@ -0,0 +1,28 @@
+This charm provides Keystone, the Openstack identity service.  It's target
+platform is Ubuntu Precise + Openstack Essex.  This has not been tested
+using Oneiric + Diablo.
+
+It provides two interfaces.
+ 
+    - identity-service:  Openstack API endpoints request an entry in the 
+      Keystone service catalog + endpoint template catalog.  When a relation
+      is established, Keystone receives: service name, region, public_url,
+      admin_url and internal_url.  It first checks that the requested service
+      is listed as a supported service.  This list should stay updated to
+      support current Openstack core services.  If the services is supported,
+      a entry in the service catalog is created, an endpoint template is
+      created and a admin token is generated.   The other end of the relation
+      recieves the token as well as info on which ports Keystone is listening.
+
+    - keystone-service:  This is currently only used by Horizon/dashboard
+      as its interaction with Keystone is different from other Openstack API
+      servicies.  That is, Horizon requests a Keystone role and token exists.
+      During a relation, Horizon requests its configured default role and
+      Keystone responds with a token and the auth + admin ports on which
+      Keystone is listening.
+
+Keystone requires a database.  By default, a local sqlite database is used.
+The charm supports relations to a shared-db via mysql-shared interface.  When
+a new data store is configured, the charm ensures the minimum administrator
+credentials exist (as configured via charm configuration)
+
diff --git a/revision b/revision
index 194b81ca..9b252fd0 100644
--- a/revision
+++ b/revision
@@ -1 +1 @@
-112
+113