docs: gooseignore negation patterns

[dianed-square]

Summary

This PR documents negation pattern support in .gooseignore files.

Documentation updates:

• documentation/docs/guides/using-gooseignore.md:
  • Add "Negation Patterns" section explaining ! prefix syntax and cross-file negation capability
  • Update "Ignore File Types and Priority" section to clarify pattern processing order (global → local)
  • Add concrete example showing how local .gooseignore can override global patterns (e.g., !.env.example overriding **/.env*)
  • Clarify that default patterns only apply when no .gooseignore files exist
  • Update tip box to explain that local patterns can override global ones using negation

Type of Change

• Feature
• Bug fix
• Refactor / Code quality
• Performance improvement
• Documentation
• Tests
• Security fix
• Build / Release
• Other (specify below)

AI Assistance

• This PR was created or reviewed with AI assistance

Testing

Manual testing:

• ✅ Verified cross-file negation works (local !.env.example overrides global **/.env*)
• ✅ Verified default patterns only apply when no ignore files exist

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1212975386605022

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-02-03 22:57 UTC

[Copilot]

Pull request overview

Documents negation (!) pattern support in .gooseignore, including how local ignore files can override global rules and when default ignore patterns apply.

Changes:

• Adds a “Negation Patterns” section with examples and guidance on pattern order.
• Clarifies global → local pattern application order and how local rules can override global ones via negation.
• Explains that default ignore patterns apply only when no .gooseignore files exist, with an explicit info callout.

[Copilot]

The example config/ then !config/template.json is likely to still prevent discovery during directory traversal because the config/ directory itself remains ignored; to make the exception work reliably, also unignore the directory (e.g., add a !config/ rule) or adjust the example text to clarify the limitation.

Suggested change

	# Re-allow the config directory so specific files can be included
	!config/

[dianed-square]

During testing, we found that directory-based negation patterns (e.g., config/ followed by !config/template.json) don't work in the current implementation. The is_ignored() function always passes false for the is_dir parameter when checking paths, so directory patterns are never properly matched. We use file glob patterns (like config/*.json) instead

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.