docs: standardize mode-specific defaults table across all configuration docs#8176
Open
shivxmsharma wants to merge 1 commit intowebpack:mainfrom
Open
docs: standardize mode-specific defaults table across all configuration docs#8176shivxmsharma wants to merge 1 commit intowebpack:mainfrom
shivxmsharma wants to merge 1 commit intowebpack:mainfrom
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
caseyjhol
reviewed
Apr 7, 2026
shivxmsharma
force-pushed
the
docs/mode-defaults-table
branch
from
af1c093 to
80426f9
Compare
shivxmsharma
force-pushed
the
docs/mode-defaults-table
branch
from
80426f9 to
ab35060
Compare
shivxmsharma
force-pushed
the
docs/mode-defaults-table
branch
from
ab35060 to
b76c0af
Compare
shivxmsharma
force-pushed
the
docs/mode-defaults-table
branch
2 times, most recently
from
ab35060 to
789ec3e
Compare
src/content/configuration/cache.mdx
Outdated
| | --------------- | ------- | | ||
| | `'production'` | `false` | | ||
| | `'development'` | `true` | | ||
| | `'none'` | `false` | |
Member
There was a problem hiding this comment.
Let's use double quotes, we are using them inside all types and we can merge
Contributor
Author
There was a problem hiding this comment.
Pushed the changes with double quotes.
shivxmsharma
force-pushed
the
docs/mode-defaults-table
branch
from
789ec3e to
4b3ee78
Compare
alexander-akait
approved these changes
Apr 10, 2026
| | --------------- | ---------- | | ||
| | `"production"` | `Infinity` | | ||
| | `"development"` | `1` | | ||
| | `"none"` | `1` | |
Member
There was a problem hiding this comment.
I think it should be Infinity for none
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #6356
Summary
Replaces all inline text descriptions of mode-specific configuration defaults with a standardized table format across the entire documentation. Supersedes #8175, which was closed because the changes were only applied partially.
Previously, mode-dependent defaults were described inconsistently using prose like "defaults to X in production mode and Y in development mode". This PR introduces a uniform table pattern and applies it globally — every configuration and plugin MDX file (65 total) was audited to ensure complete coverage.
19 options standardized across 7 files:
optimization.mdxcheckWasmTypes,concatenateModules,emitOnErrors,avoidEntryIife,flagIncludedChunks,innerGraph,mangleExports,minimize,nodeEnv,realContentHash,sideEffects,usedExportsoutput.mdxpathinfocache.mdxcache(top-level),allowCollectingMemory,maxMemoryGenerationsperformance.mdxhintsmodule.mdxparser.json.exportsDepthsplit-chunks-plugin.mdxminRemainingSizewriters-guide.mdxAll default values were verified against
webpack/lib/config/defaults.js.What kind of change does this PR introduce?
docs
Did you add tests for your changes?
N/A — documentation-only change.
Does this PR introduce a breaking change?
No.
If relevant, what needs to be documented once your changes are merged or what have you already documented?
This PR is the documentation update. The standardized table pattern has been added to the writer's guide (
writers-guide.mdx) for future contributors to follow.Use of AI
AI (Gemini) was used to assist with auditing all 65 MDX files for remaining instances of inline mode-specific defaults and to verify default values against the webpack source code. All changes were manually reviewed, implemented, and validated by me.