Adding availability zone documentation
diff --git a/README.rst b/README.rst
index 18bc492..41cd91c 100644
--- a/README.rst
+++ b/README.rst
@@ -406,6 +406,24 @@
filter_factory: 'keystonemiddleware.audit:filter_factory'
map_file: '/etc/pycadf/cinder_api_audit_map.conf'
+
+Cinder setup with custom availability zones:
+
+.. code-block:: yaml
+
+ cinder:
+ controller:
+ default_availability_zone: my-default-zone
+ storage_availability_zone: my-custom-zone-name
+ cinder:
+ volume:
+ default_availability_zone: my-default-zone
+ storage_availability_zone: my-custom-zone-name
+
+The default availability zone is used when a volume has been created, without specifying a zone in the create request. (this zone must exist in your configuration obviously)
+The storage availability zone is the actual zone where the node belongs to. Make sure to specify this per node.
+Check the documentation of OpenStack for more information
+
Documentation and Bugs
============================