diff --git a/oragono.yaml b/oragono.yaml
index 1523eed0..1f27b060 100644
--- a/oragono.yaml
+++ b/oragono.yaml
@@ -146,24 +146,24 @@ server:
 
     # IP-based DoS protection
     ip-limits:
-        # whether to enforce limits on the total number of concurrent connections per IP / CIDR
+        # whether to enforce limits on the total number of concurrent connections per IP/CIDR
         limit: true
-        # maximum concurrent connections per subnet
+        # maximum concurrent connections per IP/CIDR
         max-concurrent-connections: 16
 
-        # whether to restrict the rate of new connections per IP / CIDR
+        # whether to restrict the rate of new connections per IP/CIDR
         throttle: true
         # how long to keep track of connections for
         window: 10m
-        # maximum number of connections, per subnet, within the given duration
+        # maximum number of new connections per IP/CIDR within the given duration
         max-connections-per-window: 32
-        # how long to ban offenders for
-        # after banning them, the number of connections is reset (which lets you use UNDLINE to unban people)
+        # how long to ban offenders for. after banning them, the number of connections is
+        # reset, which lets you use /UNDLINE to unban people
         throttle-ban-duration: 10m
 
         # how wide the CIDR should be for IPv4 (a /32 is a fully specified IPv4 address)
         cidr-len-ipv4: 32
-        # how wide the cidr should be for IPv6 (a /64 is the typical prefix assigned
+        # how wide the CIDR should be for IPv6 (a /64 is the typical prefix assigned
         # by an ISP to an individual customer for their LAN)
         cidr-len-ipv6: 64
 
@@ -173,7 +173,7 @@ server:
             # - "192.168.1.1"
             # - "2001:0db8::/32"
 
-        # custom connection limits for certain IPs/networks. Note that CIDR
+        # custom connection limits for certain IPs/networks. note that CIDR
         # widths defined here override the default CIDR width --- the limit
         # will apply to the entire CIDR no matter how large or small it is
         custom-limits: