tkmind/tkmind_go
1
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

Remove gitignore fallback from gooseignore docs (#6480)

Browse Source
This commit is contained in:
Emma Youndtsmith
2026-01-13 14:18:28 -06:00
committed by GitHub
parent c222bdeab3
commit 653fa3a712
1 changed files with 4 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/docs/guides/using-gooseignore.md
+4 -18
View File
@@ -48,7 +48,7 @@ downloads/ # Ignore everything in the "downloads" directory
``` ```
## Ignore File Types and Priority ## Ignore File Types and Priority
goose respects ignore rules from three sources: global `.gooseignore`, local `.gooseignore`, and `.gitignore`. It uses a priority system to determine which files should be ignored. goose respects ignore rules from global `.gooseignore` and local `.gooseignore` files. It uses a priority system to determine which files should be ignored.
### 1. Global `.gooseignore` ### 1. Global `.gooseignore`
- Highest priority and always applied first - Highest priority and always applied first
@@ -63,7 +63,6 @@ goose respects ignore rules from three sources: global `.gooseignore`, local `.g
### 2. Local `.gooseignore` ### 2. Local `.gooseignore`
- Project-specific rules - Project-specific rules
- Located in your project root directory - Located in your project root directory
- Overrides `.gitignore` completely
``` ```
~/.config/goose/ ~/.config/goose/
@@ -71,23 +70,11 @@ goose respects ignore rules from three sources: global `.gooseignore`, local `.g
Project/ Project/
├── .gooseignore ← Local rules applied second ├── .gooseignore ← Local rules applied second
├── .gitignore ← Ignored when .gooseignore exists
└── src/ └── src/
``` ```
### 3. `.gitignore` Fallback ### 3. Default Patterns
- Used when no local `.gooseignore` exists By default, if you haven't created any .gooseignore files, goose will not modify files matching these patterns:
- goose automatically uses your `.gitignore` rules
- If a global `.gooseignore` file exists, those rules will be applied in addition to the `.gitignore` patterns.
```
Project/
├── .gitignore ← Used by goose (when no local .gooseignore)
└── src/
```
### 4. Default Patterns
By default, if you haven't created any .gooseignore files and no .gitignore file exists, goose will not modify files matching these patterns:
```plaintext ```plaintext
**/.env **/.env
**/.env.* **/.env.*
@@ -102,5 +89,4 @@ Here are some typical scenarios where `.gooseignore` is helpful:
- **Third-Party Code**: Keep goose from changing external libraries or dependencies - **Third-Party Code**: Keep goose from changing external libraries or dependencies
- **Important Configurations**: Protect critical configuration files from accidental modifications - **Important Configurations**: Protect critical configuration files from accidental modifications
- **Version Control**: Prevent changes to version control files like `.git` directory - **Version Control**: Prevent changes to version control files like `.git` directory
- **Existing Projects**: Most projects already have `.gitignore` files that work automatically as ignore patterns for goose - **Custom Restrictions**: Create `.gooseignore` files to define which files goose should not access
- **Custom Restrictions**: Create `.gooseignore` when you need different patterns than your `.gitignore` (e.g., allowing goose to read files that Git ignores)