diff --git a/etc/kayobe/inventory/group_vars/compute/network-interfaces b/etc/kayobe/inventory/group_vars/compute/network-interfaces
index 421f69d395f5866e735a68765e62bd367f53f061..0592581a458b17483621a3b0a5377c294def3b17 100644
--- a/etc/kayobe/inventory/group_vars/compute/network-interfaces
+++ b/etc/kayobe/inventory/group_vars/compute/network-interfaces
@@ -2,25 +2,18 @@
 ###############################################################################
 # Network interface definitions for the compute group.
 
-# Overcloud provisioning network IP information.
-# provision_oc_net_interface:
-# provision_oc_net_bridge_ports:
-# provision_oc_net_bond_slaves:
-
-# Internal network IP information.
-# internal_net_interface:
-# internal_net_bridge_ports:
-# internal_net_bond_slaves:
-
-# External network IP information.
-# external_net_interface:
-# external_net_bridge_ports:
-# external_net_bond_slaves:
-
-# Storage network IP information.
-# storage_net_interface:
-# storage_net_bridge_ports:
-# storage_net_bond_slaves:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
diff --git a/etc/kayobe/inventory/group_vars/controllers/network-interfaces b/etc/kayobe/inventory/group_vars/controllers/network-interfaces
index f017f602ea1bd4231a5f9cb187aff976334401f7..1c6f81f0ed6ecee5424c2c1ffb2707e0b7f1ed71 100644
--- a/etc/kayobe/inventory/group_vars/controllers/network-interfaces
+++ b/etc/kayobe/inventory/group_vars/controllers/network-interfaces
@@ -2,35 +2,18 @@
 ###############################################################################
 # Network interface definitions for the controller group.
 
-# Overcloud provisioning network IP information.
-# provision_oc_net_interface:
-# provision_oc_net_bridge_ports:
-# provision_oc_net_bond_slaves:
-
-# Workload provisioning network IP information.
-# provision_wl_net_interface:
-# provision_wl_net_bridge_ports:
-# provision_wl_net_bond_slaves:
-
-# Internal network IP information.
-# internal_net_interface:
-# internal_net_bridge_ports:
-# internal_net_bond_slaves:
-
-# External network IP information.
-# external_net_interface:
-# external_net_bridge_ports:
-# external_net_bond_slaves:
-
-# Storage network IP information.
-# storage_net_interface:
-# storage_net_bridge_ports:
-# storage_net_bond_slaves:
-
-# Storage management network IP information.
-# swift_storage_net_interface:
-# swift_storage_net_bridge_ports:
-# swift_storage_net_bond_slaves:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
diff --git a/etc/kayobe/inventory/group_vars/infra-vms/network-interfaces b/etc/kayobe/inventory/group_vars/infra-vms/network-interfaces
index 015413ded0e6c12dd582ca9fddf97f717a057843..da2a8004a19ef78d305da290ce8be18669c9f2d6 100644
--- a/etc/kayobe/inventory/group_vars/infra-vms/network-interfaces
+++ b/etc/kayobe/inventory/group_vars/infra-vms/network-interfaces
@@ -2,10 +2,18 @@
 ###############################################################################
 # Network interface definitions for the infra-vms group.
 
-# Overcloud provisioning network IP information.
-# provision_oc_net_interface:
-# provision_oc_net_bridge_ports:
-# provision_oc_net_bond_slaves:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
diff --git a/etc/kayobe/inventory/group_vars/seed-hypervisor/network-interfaces b/etc/kayobe/inventory/group_vars/seed-hypervisor/network-interfaces
new file mode 100644
index 0000000000000000000000000000000000000000..54db8cdd356c4beb789707f3fd7511ae2e85bec0
--- /dev/null
+++ b/etc/kayobe/inventory/group_vars/seed-hypervisor/network-interfaces
@@ -0,0 +1,20 @@
+---
+###############################################################################
+# Network interface definitions for the seed-hypervisor group.
+
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
+
+###############################################################################
+# Dummy variable to allow Ansible to accept this file.
+workaround_ansible_issue_8743: yes
diff --git a/etc/kayobe/inventory/group_vars/seed/network-interfaces b/etc/kayobe/inventory/group_vars/seed/network-interfaces
index 69207a3c3e713b5c8929ac7f0ecb75eaead890d4..542cf751a6bf61a6fd3393b5ecf203c9c91615d6 100644
--- a/etc/kayobe/inventory/group_vars/seed/network-interfaces
+++ b/etc/kayobe/inventory/group_vars/seed/network-interfaces
@@ -2,30 +2,18 @@
 ###############################################################################
 # Network interface definitions for the seed group.
 
-# Overcloud provisioning network IP information.
-# provision_oc_net_interface:
-# provision_oc_net_bridge_ports:
-# provision_oc_net_bond_slaves:
-
-# Workload provisioning network IP information.
-# provision_wl_net_interface:
-# provision_wl_net_bridge_ports:
-# provision_wl_net_bond_slaves:
-
-# Internal network IP information.
-# internal_net_interface:
-# internal_net_bridge_ports:
-# internal_net_bond_slaves:
-
-# External network IP information.
-# external_net_interface:
-# external_net_bridge_ports:
-# external_net_bond_slaves:
-
-# Storage network IP information.
-# storage_net_interface:
-# storage_net_bridge_ports:
-# storage_net_bond_slaves:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
diff --git a/etc/kayobe/inventory/group_vars/storage/network-interfaces b/etc/kayobe/inventory/group_vars/storage/network-interfaces
index 0b0dd5ae4ecdd7fef5a2f7c727e4f7419adefe28..45efd636c393fafa1e211d7e734b902a5ab2b2ca 100644
--- a/etc/kayobe/inventory/group_vars/storage/network-interfaces
+++ b/etc/kayobe/inventory/group_vars/storage/network-interfaces
@@ -2,35 +2,18 @@
 ###############################################################################
 # Network interface definitions for the storage group.
 
-# Overcloud provisioning network IP information.
-# provision_oc_net_interface:
-# provision_oc_net_bridge_ports:
-# provision_oc_net_bond_slaves:
-
-# External network IP information.
-# external_net_interface:
-# external_net_bridge_ports:
-# external_net_bond_slaves:
-
-# Storage network IP information.
-# storage_net_interface:
-# storage_net_bridge_ports:
-# storage_net_bond_slaves:
-
-# Storage management network IP information.
-# storage_mgmt_net_interface:
-# storage_mgmt_net_bridge_ports:
-# storage_mgmt_net_bond_slaves:
-
-# Swift storage network IP information.
-# swift_storage_net_interface:
-# swift_storage_net_bridge_ports:
-# swift_storage_net_bond_slaves:
-
-# Swift storage management network IP information.
-# swift_storage_replication_net_interface:
-# swift_storage_replication_net_bridge_ports:
-# swift_storage_replication_net_bond_slaves:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the group-specific attributes of networks. The following example shows
+# a basic configuration for a network called "example":
+#
+# example_interface: eth0
+#
+# Global network attributes such as subnet CIDRs are typically configured in
+# etc/kayobe/networks.yml.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Dummy variable to allow Ansible to accept this file.
diff --git a/etc/kayobe/networks.yml b/etc/kayobe/networks.yml
index 904311677ca50ceaf741b7ba6d3a80551ba76fe3..e58ab44cfe21e2184ca45157cbf525d847f242ed 100644
--- a/etc/kayobe/networks.yml
+++ b/etc/kayobe/networks.yml
@@ -62,115 +62,22 @@
 ###############################################################################
 # Network definitions.
 
-# Admin network IP information.
-# admin_oc_net_cidr:
-# admin_oc_net_allocation_pool_start:
-# admin_oc_net_allocation_pool_end:
-# admin_oc_net_gateway:
-# admin_oc_net_vlan:
-# admin_oc_net_mtu:
-# admin_oc_net_routes:
-
-# Overcloud out-of-band management network IP information.
-# oob_oc_net_cidr:
-# oob_oc_net_allocation_pool_start:
-# oob_oc_net_allocation_pool_end:
-# oob_oc_net_inspection_allocation_pool_start:
-# oob_oc_net_inspection_allocation_pool_end:
-# oob_oc_net_gateway:
-# oob_oc_net_vlan:
-# oob_oc_net_mtu:
-# oob_oc_net_routes:
-
-# Overcloud provisioning network IP information.
-# provision_oc_net_cidr:
-# provision_oc_net_allocation_pool_start:
-# provision_oc_net_allocation_pool_end:
-# provision_oc_net_inspection_allocation_pool_start:
-# provision_oc_net_inspection_allocation_pool_end:
-# provision_oc_net_gateway:
-# provision_oc_net_vlan:
-# provision_oc_net_mtu:
-# provision_oc_net_routes:
-
-# Workload out-of-band management network IP information.
-# oob_wl_net_cidr:
-# oob_wl_net_allocation_pool_start:
-# oob_wl_net_allocation_pool_end:
-# oob_wl_net_inspection_allocation_pool_start:
-# oob_wl_net_inspection_allocation_pool_end:
-# oob_wl_net_neutron_allocation_pool_start:
-# oob_wl_net_neutron_allocation_pool_end:
-# oob_wl_net_gateway:
-# oob_wl_net_vlan:
-# oob_wl_net_mtu:
-# oob_wl_net_routes:
-
-# Workload provisioning network IP information.
-# provision_wl_net_cidr:
-# provision_wl_net_allocation_pool_start:
-# provision_wl_net_allocation_pool_end:
-# provision_wl_net_inspection_allocation_pool_start:
-# provision_wl_net_inspection_allocation_pool_end:
-# provision_wl_net_neutron_allocation_pool_start:
-# provision_wl_net_neutron_allocation_pool_end:
-# provision_wl_net_gateway:
-# provision_wl_net_vlan:
-# provision_wl_net_mtu:
-# provision_wl_net_routes:
-
-# Internal network IP information.
-# internal_net_vip_address:
-# internal_net_fqdn:
-# internal_net_cidr:
-# internal_net_allocation_pool_start:
-# internal_net_allocation_pool_end:
-# internal_net_gateway:
-# internal_net_vlan:
-# internal_net_mtu:
-# internal_net_routes:
-
-# External network IP information.
-# external_net_vip_address:
-# external_net_fqdn:
-# external_net_cidr:
-# external_net_allocation_pool_start:
-# external_net_allocation_pool_end:
-# external_net_neutron_allocation_pool_start:
-# external_net_neutron_allocation_pool_end:
-# external_net_gateway:
-# external_net_vlan:
-# external_net_mtu:
-# external_net_routes:
-
-# Storage network IP information.
-# storage_net_cidr:
-# storage_net_allocation_pool_start:
-# storage_net_allocation_pool_end:
-# storage_net_gateway:
-# storage_net_vlan:
-# storage_net_mtu:
-# storage_net_routes:
-
-# Storage management network IP information.
-# storage_mgmt_net_cidr:
-# storage_mgmt_net_allocation_pool_start:
-# storage_mgmt_net_allocation_pool_end:
-# storage_mgmt_net_gateway:
-# storage_mgmt_net_vlan:
-# storage_mgmt_net_mtu:
-# storage_mgmt_net_routes:
-
-# Cleaning network IP information.
-# cleaning_net_cidr:
-# cleaning_net_allocation_pool_start:
-# cleaning_net_allocation_pool_end:
-# cleaning_net_neutron_allocation_pool_start:
-# cleaning_net_neutron_allocation_pool_end:
-# cleaning_net_gateway:
-# cleaning_net_vlan:
-# cleaning_net_mtu:
-# cleaning_net_routes:
+# NOTE: The content of this section is very deployment-specific, since it
+# depends on the names and types of networks in the deployment. It should
+# define the global attributes of networks. The following example shows a basic
+# configuration for a network called "example":
+#
+# example_cidr: 10.0.0.0/24
+# example_allocation_pool_start: 10.0.0.2
+# example_allocation_pool_start: 10.0.0.254
+# example_gateway: 10.0.0.1
+# example_vlan: 42
+#
+# Host or group-specific network attributes such as interface names are
+# typically configured via host or group variables.
+#
+# Further information on the available network attributes is provided in the
+# network configuration reference in the Kayobe documentation.
 
 ###############################################################################
 # Network virtual patch link configuration.