OCPBUGS-2665: Added notice for configuring macvlan

- https://issues.redhat.com/browse/OCPBUGS-2665

Signed-off-by: nicklesimba <[email protected]>

Author: nicklesimba

modules/nw-multus-macvlan-object.adoc

@@ -6,9 +6,9 @@
 = Configuration for a MACVLAN additional network
 
 The following object describes the configuration parameters for the macvlan CNI
-plug-in:
+plugin:
 
-.MACVLAN CNI plug-in JSON configuration object
+.MACVLAN CNI plugin JSON configuration object
 [cols=".^2,.^2,.^6",options="header"]
 |====
 |Field|Type|Description
@@ -23,26 +23,31 @@ plug-in:
 
 |`type`
 |`string`
-|The name of the CNI plug-in to configure: `macvlan`.
+|The name of the CNI plugin to configure: `macvlan`.
 
 |`mode`
 |`string`
 |Configures traffic visibility on the virtual network. Must be either `bridge`, `passthru`, `private`, or `vepa`. If a value is not provided, the default value is `bridge`.
 
 |`master`
 |`string`
-|The Ethernet, bonded, or VLAN interface to associate with the virtual interface. If a value is not specified, then the host system's primary Ethernet interface is used.
+|The host network interface to associate with the newly created macvlan interface. If a value is not specified, then the default route interface is used.
 
 |`mtu`
 |`string`
 |The maximum transmission unit (MTU) to the specified value. The default value is automatically set by the kernel.
 
 |`ipam`
 |`object`
-|The configuration object for the IPAM CNI plug-in. The plug-in manages IP address assignment for the attachment definition.
+|The configuration object for the IPAM CNI plugin. The plugin manages IP address assignment for the attachment definition.
 
 |====
 
+[NOTE]
+====
+If you specify the `master` key for the plugin configuration, use a different physical network interface than the one that is associated with your primary network plugin to avoid possible conflicts.
+====
+
 [id="nw-multus-macvlan-config-example_{context}"]
 == macvlan configuration example