diff --git a/README.rst b/README.rst
index 188b19f..ef03f8b 100644
--- a/README.rst
+++ b/README.rst
@@ -1727,6 +1727,39 @@
           # Add key without value to remove line from policy.json
           get_bgpvpn:tenant_id:
 
+High-available cross-az DHCP agents:
+------------------------------------
+
+Control node:
+
+.. code-block:: yaml
+
+    neutron:
+      ....
+      server:
+        dhcp_load_type: networks
+        network_scheduler_driver: neutron.scheduler.dhcp_agent_scheduler.AZAwareWeightScheduler
+      ....
+
+Network/Gateway node:
+
+.. code-block:: yaml
+
+    neutron:
+      ....
+      gateway:
+        availability_zone: nova
+      ....
+
+Compute node:
+
+.. code-block:: yaml
+
+    neutron:
+      ....
+      compute:
+        availability_zone: nova
+      ....
 
 Set nova_metadata_protocol for Neutron
 ---------------------------------------