diff --git a/docs/resources/acl.md b/docs/resources/acl.md
index 21750aa7..eac7cdde 100644
--- a/docs/resources/acl.md
+++ b/docs/resources/acl.md
@@ -10,6 +10,8 @@ description: |-
 
 The acl resource allows you to configure a Tailscale ACL. See https://tailscale.com/kb/1018/acls for more information. Note that this resource will completely overwrite existing ACL contents for a given tailnet.
 
+If tests are defined in the ACL (the top-level `tests` section), ACL validation will occur before creation and update operations are applied.
+
 ## Example Usage
 
 ```terraform