diff --git a/docs/linting/TROUBLESHOOTING.md b/docs/linting/TROUBLESHOOTING.md
index 80871c2f9c5f..9b67e19d77a7 100644
--- a/docs/linting/TROUBLESHOOTING.md
+++ b/docs/linting/TROUBLESHOOTING.md
@@ -170,6 +170,18 @@ Additionally, if you provide no `include` in your tsconfig, then it is the same
Wide globs can cause TypeScript to parse things like build artifacts, which can heavily impact performance.
Always ensure you provide globs targeted at the folders you are specifically wanting to lint.
+### Wide includes in your ESLint options
+
+Specifying `tsconfig.json` paths in your ESLint commands is also likely to cause much more disk IO than expected.
+Instead of globs that use `**` to recursively check all folders, prefer paths that use a single `*` at a time.
+
+```diff
+- eslint --parser-options project:./**/tsconfig.json
++ eslint --parser-options project:./packages/*/tsconfig.json
+```
+
+See [Glob pattern in parser's option "project" slows down linting](https://github.com/typescript-eslint/typescript-eslint/issues/2611) for more details.
+
### `eslint-plugin-prettier`
This plugin surfaces prettier formatting problems at lint time, helping to ensure your code is always formatted.
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy