Update READMEs

Change-Id: Ifa16135dbc4df8546ca831c5387e0a046242515b

README.md

@@ -0,0 +1,22 @@
+# Overview
+
+This is a "source" charm, which is intended to be strictly the top
+layer of a built charm.  This structure declares that any included
+layer assets are not intended to be consumed as a layer from a
+functional or design standpoint.
+
+# Test and Build
+
+Building, pushing and publishing to the charm store is automated
+by CI to ensure consistent flow.  Manually building is useful for
+development and testing, however.
+
+```
+tox -e pep8
+tox -e py35  # or py36
+tox -e build
+```
+
+# Contact Information
+
+Freenode IRC: #openstack-charms

src/README.md

@@ -20,3 +20,12 @@ Configuration
 =============
 
 See config.yaml for details of configuration options.
+The cinder-purestorage charm needs to be configured to point the storage array.
+Typically the settings that need configuring are:
+
+    protocol: iscsi
+    volume-backend-name: cinder-pure
+    san-ip: PURESTORAGE_IP
+    pure-api-token: API_TOKEN
+
+See config.yaml for full list of configuration options.