diff --git a/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_bond_vlan.rst b/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_bond_vlan.rst
index 84130a096..ba249126f 100644
--- a/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_bond_vlan.rst
+++ b/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_bond_vlan.rst
@@ -31,8 +31,13 @@ Define attributes in the ``nics`` table
     chdef cn1 nicips.bond0.1=40.0.0.1 nictypes.bond0.1=vlan
 
 #. Define ``nicnetworks`` for ``bond0.1`` ::
+
     chdef cn1 nicnetworks.bond0.1=net40
 
+#. Define ``nichostnamesuffixes`` for ``bond0.1`` in case ``makehosts`` to update ``/etc/hosts``, since the value for ``nichostnamesuffixes`` cannot contain ".", other characters are recommended instead of ".", like following: ::
+
+    chdef cn1 nichostnamesuffixes.bond0.1=-bond0-1 
+
 Enable ``confignetwork`` to configure bridge
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_vlan.rst b/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_vlan.rst
index 41ed6a0a9..65ee1de30 100644
--- a/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_vlan.rst
+++ b/docs/source/guides/admin-guides/manage_clusters/common/deployment/network/cfg_network_vlan.rst
@@ -31,6 +31,10 @@ Define attributes in the ``nics`` table
 
     chdef cn1 nicnetworks.eth0.6=net60 nicnetworks.eth0.7=net70
 
+#. Define ``nichostnamesuffixes`` for ``eth0.6`` and ``eth0.7`` in case ``makehosts`` to update ``/etc/hosts``, since the value for ``nichostnamesuffixes`` cannot contain ".", other characters are recommended instead of ".", like following: ::
+
+    chdef cn1 nichostnamesuffixes.eth0.6=-eth0-6 nichostnamesuffixes.eth0.7=-eth0-7
+
 Enable ``confignetwork`` to configure VLAN
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~