DOC: Proofreading bonding.rst (#1721)

1 files changed, 22 insertions, 26 deletions

diff --git a/docs/_include/interface-vlan-8021q.txt b/docs/_include/interface-vlan-8021q.txt
index 1a527590..1a7a665f 100644
--- a/docs/_include/interface-vlan-8021q.txt
+++ b/docs/_include/interface-vlan-8021q.txt
@@ -1,33 +1,29 @@
-IEEE 802.1q_, often referred to as Dot1q, is the networking standard that
-supports virtual LANs (VLANs) on an IEEE 802.3 Ethernet network. The standard
-defines a system of VLAN tagging for Ethernet frames and the accompanying
-procedures to be used by bridges and switches in handling such frames.
-The standard also contains provisions for a quality-of-service prioritization
-scheme commonly known as IEEE 802.1p and defines the
-Generic Attribute Registration Protocol.
-
-Portions of the network which are VLAN-aware (i.e., IEEE 802.1q_ conformant) can
-include VLAN tags. When a frame enters the VLAN-aware portion of the network, a
-tag is added to represent the VLAN membership. Each frame must be
-distinguishable as being within exactly one VLAN. A frame in the VLAN-aware
-portion of the network that does not contain a VLAN tag is assumed to be
-flowing on the native VLAN.
-
-The standard was developed by IEEE 802.1, a working group of the IEEE 802
-standards committee, and continues to be actively revised. One of the notable
-revisions is 802.1Q-2014 which incorporated IEEE 802.1aq
-(Shortest Path Bridging) and much of the IEEE 802.1d standard.
-
-802.1q VLAN interfaces are represented as virtual sub-interfaces in VyOS. The
-term used for this is ``vif``.
+IEEE 802.1q_, often referred to as Dot1q, is the industry standard for 
+implementing VLANs on Ethernet networks. It defines VLAN tagging for 
+Ethernet frames and outlines procedures for bridges and switches. The 
+standard also includes quality-of-service prioritization (IEEE 802.1p) 
+and defines the Generic Attribute Registration Protocol.
+
+VLAN-aware network segments  (i.e., IEEE 802.1q_ conformant) use VLAN tags. 
+When a frame enters such a segment, a tag is added to indicate VLAN membership. 
+Each frame can belong to only one VLAN. If a frame arrives without a tag, it 
+is assumed to be part of the native VLAN.
+
+IEEE 802.1, a working group of the IEEE 802 standards committee, has developed 
+the standard and continues to revise it. One notable revision is 802.1Q-2014, 
+which incorporated IEEE 802.1aq (Shortest Path Bridging) and much of the IEEE 
+802.1d standard. 
+
+In VyOS, 802.1q VLAN interfaces are represented as virtual subinterfaces, 
+referred to as  ``vif``.
 
 .. cfgcmd:: set interfaces {{ var0 }} <interface> vif <vlan-id>
 
-  Create a new VLAN interface on interface `<interface>` using the VLAN number
-  provided via `<vlan-id>`.
+  **Configure a VLAN interface with a unique VLAN ID.** 
+
+  VLAN ID identifies a specific VLAN and ranges from 0 to 4094. 
 
-  You can create multiple VLAN interfaces on a physical interface. The VLAN ID
-  range is from 0 to 4094.
+  You can configure multiple VLAN interfaces on a single physical interface.
 
   .. note:: Only 802.1Q-tagged packets are accepted on Ethernet vifs.