docs(escape-hatches): mark lint-intentional example + suppress in sandbox (#8045)
Fixes #8045
Summary
This PR clarifies the Escape Hatches documentation by marking one example as intentionally problematic and suppressing the linter in the sandbox.
- Added a note explaining that the
optionsobject example in Removing Effect dependencies is expected to show a linter error. - Suppressed the
react-hooks/exhaustive-depswarning inline so the sandbox still runs without noise.
Why
- The previous example looked like a bug rather than a teaching tool.
- This change makes it clear to readers that the linter error is intentional, avoiding confusion.
Changes
- Updated
src/content/learn/escape-hatches.md
Testing
- Docs-only change, verified sandbox still works as intended.
Size changes
📦 Next.js Bundle Analysis for react-dev
This analysis was generated by the Next.js Bundle Analysis action. 🤖
🎉 Global Bundle Size Decreased
| Page | Size (compressed) |
|---|---|
global |
110.53 KB (-8 B) |
Details
The global bundle is the javascript bundle that loads alongside every page. It is in its own category because its impact is much higher - an increase to its size means that every page on your website loads slower, and a decrease means every page loads faster.
Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis
If you want further insight into what is behind the changes, give @next/bundle-analyzer a try!
Five Pages Changed Size
The following pages changed size from the code in this PR compared to its base branch:
| Page | Size (compressed) | First Load |
|---|---|---|
/404 |
128.07 KB (-5 B) |
238.6 KB |
/500 |
128.08 KB (-5 B) |
238.61 KB |
/[[...markdownPath]] |
130.52 KB (-5 B) |
241.05 KB |
/errors |
128.32 KB (-5 B) |
238.85 KB |
/errors/[errorCode] |
128.3 KB (-5 B) |
238.83 KB |
Details
Only the gzipped size is provided here based on an expert tip.
First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If next/link is used, subsequent page loads would only need to download that page's bundle (the number in the "Size" column), since the global bundle has already been downloaded.
Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis
Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this.