diff --git a/etc/kayobe/networks.yml b/etc/kayobe/networks.yml
index c9219b8..bf86310 100644
--- a/etc/kayobe/networks.yml
+++ b/etc/kayobe/networks.yml
@@ -2,15 +2,32 @@
 # Kayobe network configuration.
 
 ###############################################################################
-# Network roles.
-
 # Network role to network mappings.
-#provision_oc_net_name: 'provision_oc_net'
-#provision_wl_net_name: 'provision_wl_net'
-#internal_net_name: 'internal_net'
-#external_net_name: 'external_net'
-#storage_net_name: 'storage_net'
-#storage_mgmt_net_name: 'storage_mgmt_net'
+
+# Name of the network used by the seed to provision the bare metal overcloud
+# hosts.
+#provision_oc_net_name:
+
+# Name of the network used by the overcloud hosts to provision the bare metal
+# workload hosts.
+#provision_wl_net_name:
+
+# Name of the network used to expose the internal OpenStack API endpoints.
+#internal_net_name:
+
+# Name of the network used to expose the external OpenStack API endpoints and
+# to provide external network access via Neutron.
+#external_net_name:
+
+# Name of the network used to carry storage data traffic.
+#storage_net_name:
+
+# Name of the network used to carry storage management traffic.
+#storage_mgmt_net_name:
+
+# Name of the network used to perform hardware introspection on the bare metal
+# workload hosts.
+#inspection_net_name:
 
 ###############################################################################
 # Network definitions.
@@ -61,6 +78,23 @@
 # storage_mgmt_net_gateway:
 # storage_mgmt_net_vlan:
 
+###############################################################################
+# Network virtual patch link configuration.
+
+# Suffix for Open vSwitch bridge names.
+#network_bridge_suffix_ovs:
+
+# Prefix for virtual patch interface names.
+#network_patch_prefix:
+
+# Suffix for virtual patch link interface names when connected towards the
+# physical interface.
+#network_patch_suffix_phy:
+
+# Suffix for virtual patch link interface names when connected towards the
+# OVS bridge.
+#network_patch_suffix_ovs:
+
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
 workaround_ansible_issue_8743: yes