Add documentation and bug links
Change-Id: I7a29a46440f26d654fcdd529aeee38e9d1146671
Closes-Bug: #1583855
diff --git a/README.rst b/README.rst
index 15c19cd..38734eb 100644
--- a/README.rst
+++ b/README.rst
@@ -2,12 +2,15 @@
Openstack Cinder Block Storage
==============================
-Cinder provides an infrastructure for managing volumes in OpenStack. It was originally a Nova component called nova-volume, but has become an independent project since the Folsom release.
+Cinder provides an infrastructure for managing volumes in OpenStack. It was
+originally a Nova component called nova-volume, but has become an independent
+project since the Folsom release.
Sample pillars
==============
-New structure divides cinder-api,cinder-scheduler to role controller and cinder-volume to role volume.
+New structure divides cinder-api,cinder-scheduler to role controller and
+cinder-volume to role volume.
.. code-block:: yaml
@@ -363,7 +366,29 @@
san_password: password
clustername: cluster1
sf_emulate_512: false
-## Read more
-* https://wiki.openstack.org/wiki/Cinder
-* http://docs.openstack.org/juno/config-reference/content/hitachi-configuration.html
+Documentation and Bugs
+============================
+
+To learn how to deploy OpenStack Salt, consult the documentation available
+online at:
+
+ https://wiki.openstack.org/wiki/OpenStackSalt
+
+In the unfortunate event that bugs are discovered, they should be reported to
+the appropriate bug tracker. If you obtained the software from a 3rd party
+operating system vendor, it is often wise to use their own bug tracker for
+reporting problems. In all other cases use the master OpenStack bug tracker,
+available at:
+
+ http://bugs.launchpad.net/openstack-salt
+
+Developers wishing to work on the OpenStack Salt project should always base
+their work on the latest formulas code, available from the master GIT
+repository at:
+
+ https://git.openstack.org/cgit/openstack/salt-formula-cinder
+
+Developers should also join the discussion on the IRC list, at:
+
+ https://wiki.openstack.org/wiki/Meetings/openstack-salt