docs: drop the built-in-superseded loaders and plugins from the indexes - #8344
Merged
alexander-akait merged 5 commits intoAug 30, 2026
Merged
Conversation
css-loader, style-loader, html-loader, MiniCssExtractPlugin and HtmlWebpackPlugin are no longer listed on /loaders/ and /plugins/, the same treatment file-loader, url-loader and raw-loader got when asset modules replaced them. Each page stays reachable and is linked from the note that replaces its entry, so the options with no built-in equivalent are still documented.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
The guide series builds its CSS with the built-in support, so production's devDependencies listed css-loader and style-loader that nothing installs. output.mdx sent readers to css-loader's docs for localIdentName, which webpack has as a generator option. The UseEntry and kebab-case examples and the awesome-webpack ecosystem list named them where any loader would do.
…tractPlugin The site documents native CSS but did not use it. The rule keeps postcss-loader for Tailwind and hands the result to webpack via type: css/auto; output.cssFilename reproduces the plugin's names. Verified against the previous config: 382 emitted files and 188 pages both ways, the vendor stylesheet byte-identical (97fc31c3662cb803), and index.css differing by two bytes because webpack quotes the @import url. The stray stylesheet the SSG pass emits drops from 48.6 KB to 177 B.
webpack minifies CSS itself and deliberately steps aside when another minimizer claims those assets, so the plugin was displacing it. Dropping it is a gzip win on both stylesheets: vendor 5939 -> 5884 B and the main sheet 13181 -> 13130 B, 106 B less over the wire. The ssg pass replaced the default minimizers rather than extending them, so its server bundle was never minified and the stylesheet it emits is unreferenced; it now says minimize: false instead. All 188 pages stay byte-identical and the emitted file list is unchanged.
bjohansebas
previously approved these changes
Aug 29, 2026
|
Review the following changes in direct dependencies. Learn more about Socket for GitHub.
|
alexander-akait
deleted the
claude/webpack-docs-migration-guides-q3s7v3
branch
August 30, 2026 16:26
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
2 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.
Summary
Follow-up to #8342.
/loaders/and/plugins/still listedcss-loader,style-loader,html-loader,MiniCssExtractPluginandHtmlWebpackPluginamong the packages you install, even though webpack now does that work itself — this removes them, the same treatmentfile-loader,url-loaderandraw-loadergot when Asset Modules replaced them.The
T>note above each list now says why the entry is gone and links to the package's page, so the options with no built-in equivalent (css-loader'simportLoaders/getJSON,style-loader'sinsertand lazy modes,html-webpack-plugin's hooks) stay findable — the What's built-in tables cite exactly those. The pages themselves are kept: twelve links fromconfiguration/module,configuration/output,output-managementand the 2026 roadmap post point at them, and plenty of plugin pages (split-chunks-plugin,module-federation-plugin) already exist without a row in that table.What kind of change does this PR introduce?
docs
Did you add tests for your changes?
No — documentation only.
prettier,markdownlintandeslintare clean across the repo andjestpasses 25/25 suites, 97 tests.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?
n/a — this PR is the documentation. The matching README change is webpack/webpack#21855.
Use of AI
This PR was prepared with Claude Code. The entries removed were checked against the What's built-in scope tables, and every link target was confirmed to be a page that is still generated and still linked from elsewhere in the docs before deciding to keep it. All output was reviewed before committing.
Generated by Claude Code