diff --git a/docs/rules/template-no-autofocus-attribute.md b/docs/rules/template-no-autofocus-attribute.md
index b3bc9bd425..b257beac98 100644
--- a/docs/rules/template-no-autofocus-attribute.md
+++ b/docs/rules/template-no-autofocus-attribute.md
@@ -40,6 +40,34 @@ Examples of **correct** code for this rule:
```
+Explicit opt-out via a mustache boolean `false` is allowed — this is the
+only form that statically guarantees no rendered `autofocus` attribute
+(Glimmer VM normalizes `{{false}}` to attribute removal). The string
+`autofocus="false"` is still flagged per HTML boolean-attribute semantics
+(any attribute presence, including the string `"false"`, enables autofocus).
+
+```gjs
+
+
+ {{!-- element syntax: the mustache-boolean form --}}
+
+ {{input autofocus=false}}
+ {{!-- mustache syntax: the hash-pair form --}}
+
+```
+
+`