add crud info to readme

1 files changed, 15 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index 3277d4446..600aaa3ce 100644
--- a/README.rst
+++ b/README.rst
@@ -7,6 +7,9 @@ Keystone Light is a re-interpretation of the Keystone project that provides
 Identity, Token and Catalog services for use specifically by projects in the
 OpenStack family.
 
+Much of the design is precipitated from the expectation that the auth backends
+for most deployments will actually be shims in front of existing user systems.
+
 
 ----------
 Data Model
@@ -87,6 +90,18 @@ Diagram: keystone_compat_flows.sdx_
 
 ..  _: https://raw.github.com/termie/keystonelight/master/docs/keystone_compat_flows.sdx
 
+----------------
+Approach to CRUD
+----------------
+
+While it is expected that any "real" deployment at a large company will manage
+their users, tenants and other metadata in their existing user systems, a
+variety of CRUD operations are provided for the sake of development and testing.
+
+CRUD is treated as an extension or additional feature to the core feature set in
+that it is not required that a backend support it.
+
+
 -----------
 Still To Do
 -----------