Clarify wildcard behavior in watch paths

[ask-bonk]

Here's a summary of the changes made to src/content/docs/pages/configuration/build-watch-paths.mdx:

Problem: The documentation was misleading about how the * wildcard works in build watch paths. Users expected standard shell glob behavior where * does not match path separators (/), meaning dir/* would only match files directly inside dir/ but not in nested subdirectories. The wildcard note also used a branch-matching example that was confusing in a file path context.

Changes made:

1. Clarified wildcard behavior: Rewrote the :::note[Wildcard syntax] callout to explicitly state that * matches including path separators (/). Added concrete examples showing that docs/* matches files at any nesting depth (docs/README.md, docs/guides/setup.md, docs/guides/advanced/config.md).

2. Removed confusing branch example: The old note used a branch-matching example (fix/* matching branch names) which was out of place on a file path documentation page. Replaced it with file path examples relevant to the actual use case.

3. Improved examples section:

   • Gave each example a descriptive heading instead of generic "Example 1/2/3" names.
   • Added explicit mention that patterns match nested subdirectories with concrete file path examples.
   • Added a new fourth example showing how to combine include/exclude to match a directory but exclude a subdirectory within it.

4. Fixed minor typo: "a empty push event" -> "an empty push event".

Closes #27710

github run

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/docs/pages/	@cloudflare/workers-docs, @GregBrimble, @WalshyDev, @aninibread, @irvinebroque, @cloudflare/pcx-technical-writing

[github-actions]

Preview URL: https://6a6fa031.preview.developers.cloudflare.com
Preview Branch URL: https://opencode-issue27710-20260206201942.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/pages/configuration/build-watch-paths/	https://opencode-issue27710-20260206201942.preview.developers.cloudflare.com/pages/configuration/build-watch-paths/

[DaviDevMod]

This is wild! (no pun intended)

However I'm not sure it's a real fix.
In the issue I stated "dir/* doesn't recursevely includes subdirectories."
The fact that now we have docs about nested directories is nice. But I hope the docs are accurate. I'll test again whether dir/* actually includes subdirectories.