diff --git a/default.yaml b/default.yaml
index 361c3f76..8da88e09 100644
--- a/default.yaml
+++ b/default.yaml
@@ -623,9 +623,9 @@ oper-classes:
         # capability names
         capabilities:
             - "kill"      # disconnect user sessions
-            - "ban"       # ban IPs, CIDRs, and NUH masks ("d-line" and "k-line")
-            - "nofakelag" # remove "fakelag" restrictions on rate of message sending
-            - "relaymsg"  # use RELAYMSG in any channel (see the 'relaymsg' config block)
+            - "ban"       # ban IPs, CIDRs, NUH masks, and suspend accounts (UBAN / DLINE / KLINE)
+            - "nofakelag" # exempted from "fakelag" restrictions on rate of message sending
+            - "relaymsg"  # use RELAYMSG in any channel (see the `relaymsg` config block)
             - "vhosts"    # add and remove vhosts from users
             - "sajoin"    # join arbitrary channels, including private channels
             - "samode"    # modify arbitrary channel and user modes
diff --git a/traditional.yaml b/traditional.yaml
index 7a4827ca..7ea27137 100644
--- a/traditional.yaml
+++ b/traditional.yaml
@@ -595,9 +595,9 @@ oper-classes:
         # capability names
         capabilities:
             - "kill"      # disconnect user sessions
-            - "ban"       # ban IPs, CIDRs, and NUH masks ("d-line" and "k-line")
-            - "nofakelag" # remove "fakelag" restrictions on rate of message sending
-            - "relaymsg"  # use RELAYMSG in any channel (see the 'relaymsg' config block)
+            - "ban"       # ban IPs, CIDRs, NUH masks, and suspend accounts (UBAN / DLINE / KLINE)
+            - "nofakelag" # exempted from "fakelag" restrictions on rate of message sending
+            - "relaymsg"  # use RELAYMSG in any channel (see the `relaymsg` config block)
             - "vhosts"    # add and remove vhosts from users
             - "sajoin"    # join arbitrary channels, including private channels
             - "samode"    # modify arbitrary channel and user modes