diff --git a/configs/nixos/modules/network/vlans.nix b/configs/nixos/modules/network/vlans.nix
index 366f838..87872dd 100644
--- a/configs/nixos/modules/network/vlans.nix
+++ b/configs/nixos/modules/network/vlans.nix
@@ -4,7 +4,7 @@
   util,
   ...
 }:
-# Configures bridges for tagged VLANs on a DHCP-managed physical interface.
+# Configures bridges for tagged VLANs on a physical interface that uses DHCP.
 let
   cfg = config.modules.network.vlans; # NOLINT(let_order)
   vlanName = id: "vlan${toString id}";
@@ -15,7 +15,7 @@ in
       type = lib.types.str;
       example = "enp1s0";
       description = ''
-        Physical interface that carries untagged DHCP traffic and tagged VLANs.
+        Names the physical interface that carries untagged DHCP traffic and tagged VLANs.
       '';
     };
 
@@ -28,7 +28,8 @@ in
         30
       ];
       description = ''
-        Materializes bridges for these tagged VLAN IDs.
+        Creates bridges for the specified tagged VLAN IDs.
+
         VLAN ID N creates bridge `br-vlanN`.
       '';
     };