DOC: Proofread pseudo-ethernet.rst (#1791)

* DOC: Proofread pseudo-ethernet.rst

---------

Co-authored-by: Daniil Baturin <daniil@baturin.org>

1 files changed, 26 insertions, 39 deletions

diff --git a/docs/configuration/interfaces/pseudo-ethernet.rst b/docs/configuration/interfaces/pseudo-ethernet.rst
index 59b3581c..cb42fafc 100644
--- a/docs/configuration/interfaces/pseudo-ethernet.rst
+++ b/docs/configuration/interfaces/pseudo-ethernet.rst
@@ -1,44 +1,32 @@
-:lastproofread: 2023-01-26
+:lastproofread: 2026-03-05
 
 .. _pseudo-ethernet-interface:
 
 #########################
-MACVLAN - Pseudo Ethernet
+MACVLAN (pseudo-Ethernet)
 #########################
 
-Pseudo-Ethernet or MACVLAN interfaces can be seen as subinterfaces to regular
-ethernet interfaces. Each and every subinterface is created a different media
-access control (MAC) address, for a single physical Ethernet port. Pseudo-
-Ethernet interfaces have most of their application in virtualized environments,
-
-By using Pseudo-Ethernet interfaces there will be less system overhead compared
-to running a traditional bridging approach. Pseudo-Ethernet interfaces can also
-be used to workaround the general limit of 4096 virtual LANs (VLANs) per
-physical Ethernet port, since that limit is with respect to a single MAC
-address.
-
-Every Virtual Ethernet interfaces behaves like a real Ethernet interface. They
-can have IPv4/IPv6 addresses configured, or can request addresses by DHCP/
-DHCPv6 and are associated/mapped with a real ethernet port. This also makes
-Pseudo-Ethernet interfaces interesting for testing purposes. A Pseudo-Ethernet
-device will inherit characteristics (speed, duplex, ...) from its physical
-parent (the so called link) interface.
-
-Once created in the system, Pseudo-Ethernet interfaces can be referenced in
-the exact same way as other Ethernet interfaces. Notes about using Pseudo-
-Ethernet interfaces:
-
-* Pseudo-Ethernet interfaces can not be reached from your internal host. This
-  means that you can not try to ping a Pseudo-Ethernet interface from the host
-  system on which it is defined. The ping will be lost.
-* Loopbacks occurs at the IP level the same way as for other interfaces,
-  ethernet frames are not forwarded between Pseudo-Ethernet interfaces.
-* Pseudo-Ethernet interfaces may not work in environments which expect a
-  :abbr:`NIC (Network Interface Card)` to only have a single address. This
-  applies to:
-  - VMware machines using default settings
-  - Network switches with security settings allowing only a single MAC address
-  - xDSL modems that try to learn the MAC address of the NIC
+MACVLAN, or pseudo-Ethernet interfaces, operate as logical subinterfaces of 
+standard Ethernet interfaces. Each subinterface has a unique MAC address but 
+shares a single physical Ethernet port.
+That allows the user to send packets from different source IPv4 or IPv6 addresses
+using a different MAC address.
+
+
+Pseudo-Ethernet interfaces behave like physical Ethernet interfaces. They 
+support IPv4 and IPv6 addressing, can obtain IP addresses through DHCP or 
+DHCPv6, and are mapped to a physical Ethernet port. They inherit 
+characteristics such as speed and duplex from their parent interface and can 
+be referenced like standard Ethernet interfaces once created. 
+
+
+Pseudo-Ethernet interfaces may not work in environments that require a 
+  :abbr:`NIC (Network Interface Card)` to have only one MAC address. 
+  This includes:
+
+  * VMware machines with default settings.
+  * Network switches that permit only a single MAC address.
+  * xDSL modems that learn the NIC's MAC address.
 
 *************
 Configuration
@@ -51,13 +39,12 @@ Common interface configuration
    :var0: pseudo-ethernet
    :var1: peth0
 
-Pseudo Ethernet/MACVLAN options
-===============================
+MACVLAN (pseudo-Ethernet) options
+=================================
 
 .. cfgcmd:: set interfaces pseudo-ethernet <interface> source-interface <ethX>
 
-   Specifies the physical `<ethX>` Ethernet interface associated with a Pseudo
-   Ethernet `<interface>`.
+   Assign a physical Ethernet interface to the specified pseudo-Ethernet interface.
 
 VLAN
 ====