OCPBUGS-38402: Updated the Example policy configurations for different interfaces section

Author: dfitzmau

modules/virt-nmstate-example-policy-configurations.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+//
+// * networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="virt-nmstate-example-policy-configurations"]
+== Example policy configurations for different interfaces
+
+Before reading the different example `NodeNetworkConfigurationPolicy` (NNCP) manifest configurations, consider the following factors when applying a policy so that your cluster runs at its best performance conditions:
+
+* When you need to apply a policy to more than one node, create a `NodeNetworkConfigurationPolicy` manifest for each target node. The Kubernetes NMState Operator applies the policy to each node with an NNCP in an unspecified order. Scoping a policy with this approach reduces the overall length of time for the Kubernetes NMState Operator to apply the policy to target nodes and focuses any outages at the single-node level.
+
+* When you need to apply a policy to many nodes but you only want to create a single NNCP for all target nodes, the Kubernetes NMState Operator applies the policy to each node in sequence, which increases the overall length of time for policy application. With this approach, an outage occurs at a cluster-wide level that impacts all nodes that use the single NNCP.
+
+* All related network configurations should be specified in a single policy.
+
+* When a node restarts, the Kubernetes NMState Operator cannot control the order that it applies policies to nodes. The Kubernetes NMState Operator might apply interdependent policies in a sequence that results in a degraded network object.

networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc

@@ -35,20 +35,8 @@ include::modules/virt-confirming-policy-updates-on-nodes.adoc[leveloffset=+2]
 
 include::modules/virt-removing-interface-from-nodes.adoc[leveloffset=+2]
 
-[id="virt-nmstate-example-policy-configurations"]
-== Example policy configurations for different interfaces
-
-The following examples show different `NodeNetworkConfigurationPolicy` manifest configurations.
-
-For best performance, consider the following factors when applying a policy:
-
-* When you need to apply a policy to more than one node, create a `NodeNetworkConfigurationPolicy` manifest for each target node. Scoping a policy to a single node reduces the overall length of time for the Kubernetes NMState Operator to apply the policies.
-+
-In contrast, if a single policy includes configurations for several nodes, the Kubernetes NMState Operator applies the policy to each node in sequence, which increases the overall length of time for policy application.
-
-* All related network configurations should be specified in a single policy.
-+
-When a node restarts, the Kubernetes NMState Operator cannot control the order in which policies are applied. Therefore, the Kubernetes NMState Operator might apply interdependent policies in a sequence that results in a degraded network object.
+// Example policy configurations for different interfaces
+include::modules/virt-nmstate-example-policy-configurations.adoc[leveloffset=+1]
 
 include::modules/virt-example-bridge-nncp.adoc[leveloffset=+2]