diff --git a/README.rst b/README.rst
index 25eb136..fe06a85 100644
--- a/README.rst
+++ b/README.rst
@@ -1293,8 +1293,38 @@
         security_groups_enabled: False
 
 
-Neutron Client
---------------
+Neutron Client Resources
+------------------------
+
+Neutron network:
+
+.. code-block:: yaml
+
+      parameters:
+        neutron:
+          client:
+            enabled: true
+            resources:
+              v2:
+                admin_identity:
+                  network:
+                    corporate:
+                      shared: False
+                      router_external: True
+                      subnet:
+                        corporate:
+                          cidr: ${_param:fip_corporate_subnet_cidr}
+                          enable_dhcp: False
+                          ip_version: 4
+                          allocation_pools:
+                            - start: ${_param:fip_corporate_allocation_start}
+                              end: ${_param:fip_corporate_allocation_end}
+
+Neutron Client (deprecated)
+---------------------------
+
+Neutron client is deprecated. Please use neutron client resources definitions
+instead.
 
 Neutron networks and RBAC: