diff --git a/snippets/schema-reference/module/stack.mdx b/snippets/schema-reference/module/stack.mdx
index 51f949b..1a5c7dd 100644
--- a/snippets/schema-reference/module/stack.mdx
+++ b/snippets/schema-reference/module/stack.mdx
@@ -394,7 +394,16 @@ Trigger filter configuration
- Only trigger when files in these paths are changed
+ Only trigger when files in these paths are changed.
+ Each entry is a glob matched against every changed file path, relative to
+ the repository root: `*` matches within one path segment, `**` matches
+ across segments, and `{a,b}` and `[abc]` are supported. Dotfiles are
+ matched, and a leading `/` is ignored.
+ Prefix a pattern with `!` to exclude files: a changed file counts only if
+ it matches at least one non-`!` pattern and no `!` pattern. When every
+ pattern is a `!` exclusion, all changed files are included first, so
+ `paths: ["!docs/**"]` means "any change outside docs/".
+ The trigger fires when at least one changed file counts.
_(templateable)_
diff --git a/snippets/schema-reference/pipeline.mdx b/snippets/schema-reference/pipeline.mdx
index 84a76a1..9588812 100644
--- a/snippets/schema-reference/pipeline.mdx
+++ b/snippets/schema-reference/pipeline.mdx
@@ -352,7 +352,16 @@ Trigger filter configuration
- Only trigger when files in these paths are changed
+ Only trigger when files in these paths are changed.
+ Each entry is a glob matched against every changed file path, relative to
+ the repository root: `*` matches within one path segment, `**` matches
+ across segments, and `{a,b}` and `[abc]` are supported. Dotfiles are
+ matched, and a leading `/` is ignored.
+ Prefix a pattern with `!` to exclude files: a changed file counts only if
+ it matches at least one non-`!` pattern and no `!` pattern. When every
+ pattern is a `!` exclusion, all changed files are included first, so
+ `paths: ["!docs/**"]` means "any change outside docs/".
+ The trigger fires when at least one changed file counts.
_(templateable)_