From 5ba2aae7f3360c377ecd1d6af5ffba7889fbefb0 Mon Sep 17 00:00:00 2001 From: Sameer Chore Date: Wed, 28 Oct 2026 02:25:48 +0530 Subject: [PATCH 1/3] docs: drop archived loaders and plugins from index pages The loader and plugin pages are generated only for repositories that are not archived, so the index tables linked to pages that no longer exist. List the maintained packages, add diagnostics-webpack-plugin, and move the archived ones to a deprecated section that points to their replacements. Closes #291 --- pages/docs/loaders/index.md | 39 +++++++++++++++++++++++-------------- pages/docs/plugins/index.md | 32 ++++++++++++++++++++---------- 2 files changed, 46 insertions(+), 25 deletions(-) diff --git a/pages/docs/loaders/index.md b/pages/docs/loaders/index.md index fa4e87b2..6d8e18f9 100644 --- a/pages/docs/loaders/index.md +++ b/pages/docs/loaders/index.md @@ -1,6 +1,6 @@ --- title: Loaders -authors: ryzrr +authors: ryzrr, samc4e --- # Loaders @@ -13,17 +13,26 @@ into a build. The loaders below are maintained by the webpack organization. -| Loader | Description | -| ------------------------------------------------ | ---------------------------------------------------------------------------------- | -| [`css-loader`](/docs/loaders/css-loader) | Resolve `@import` and `url()` in CSS the way `import` and `require()` are resolved | -| [`style-loader`](/docs/loaders/style-loader) | Inject CSS into the DOM | -| [`sass-loader`](/docs/loaders/sass-loader) | Compile Sass and SCSS to CSS | -| [`less-loader`](/docs/loaders/less-loader) | Compile Less to CSS | -| [`stylus-loader`](/docs/loaders/stylus-loader) | Compile Stylus to CSS | -| [`postcss-loader`](/docs/loaders/postcss-loader) | Process CSS with PostCSS | -| [`html-loader`](/docs/loaders/html-loader) | Export HTML as a string and resolve its asset references | -| [`coffee-loader`](/docs/loaders/coffee-loader) | Compile CoffeeScript to JavaScript | -| [`exports-loader`](/docs/loaders/exports-loader) | Add exports to a module that does not define its own | -| [`imports-loader`](/docs/loaders/imports-loader) | Provide global variables to a module that expects them | -| [`expose-loader`](/docs/loaders/expose-loader) | Expose a module on the global object | -| [`thread-loader`](/docs/loaders/thread-loader) | Run the loaders that follow it in a worker pool | +| Loader | Description | +| ------------------------------------------------ | ----------------------------------------------- | +| [`sass-loader`](/docs/loaders/sass-loader) | Compile Sass and SCSS to CSS | +| [`less-loader`](/docs/loaders/less-loader) | Compile Less to CSS | +| [`stylus-loader`](/docs/loaders/stylus-loader) | Compile Stylus to CSS | +| [`postcss-loader`](/docs/loaders/postcss-loader) | Process CSS with PostCSS | +| [`coffee-loader`](/docs/loaders/coffee-loader) | Compile CoffeeScript to JavaScript | +| [`thread-loader`](/docs/loaders/thread-loader) | Run the loaders that follow it in a worker pool | + +## Deprecated loaders + +webpack now covers what these loaders did, so their repositories are archived +and they are no longer documented here. + +| Loader | Use instead | +| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| [`css-loader`](https://github.com/webpack/css-loader) | [Native CSS](/guides/modern-web/native-css#4-replace-css-loader) | +| [`style-loader`](https://github.com/webpack/style-loader) | [Native CSS](/guides/modern-web/native-css#5-replace-style-loader) | +| [`html-loader`](https://github.com/webpack/html-loader) | [`experiments.html`](/docs/api/options#experimentshtml) | +| [`exports-loader`](https://github.com/webpack/exports-loader) | A small plugin, see the [migration recipe](https://github.com/webpack/exports-loader#deprecation) | +| [`imports-loader`](https://github.com/webpack/imports-loader) | A small plugin, see the [add-imports example](https://github.com/webpack/webpack/tree/main/examples/add-imports) | +| [`expose-loader`](https://github.com/webpack/expose-loader) | A small plugin, see the [migration recipe](https://github.com/webpack/expose-loader#deprecation) | +| [`remark-loader`](https://github.com/webpack/remark-loader) | The [markdown example](https://github.com/webpack/webpack/tree/main/examples/markdown) | diff --git a/pages/docs/plugins/index.md b/pages/docs/plugins/index.md index a7f31f7c..3d177599 100644 --- a/pages/docs/plugins/index.md +++ b/pages/docs/plugins/index.md @@ -1,6 +1,6 @@ --- title: Plugins -authors: ryzrr +authors: ryzrr, samc4e --- # Plugins @@ -13,12 +13,24 @@ into a build. Plugins built into webpack are documented in the [API reference](/docs/api). The plugins below are separate packages maintained by the webpack organization. -| Plugin | Description | -| -------------------------------------------------------------------------------- | ------------------------------------------------------------------- | -| [`mini-css-extract-plugin`](/docs/plugins/mini-css-extract-plugin) | Extract CSS into separate files, one per JS file that imports CSS | -| [`copy-webpack-plugin`](/docs/plugins/copy-webpack-plugin) | Copy individual files or whole directories into the build output | -| [`compression-webpack-plugin`](/docs/plugins/compression-webpack-plugin) | Emit compressed versions of assets to serve with `Content-Encoding` | -| [`image-minimizer-webpack-plugin`](/docs/plugins/image-minimizer-webpack-plugin) | Compress images during the build | -| [`eslint-webpack-plugin`](/docs/plugins/eslint-webpack-plugin) | Run ESLint on your modules during the build | -| [`stylelint-webpack-plugin`](/docs/plugins/stylelint-webpack-plugin) | Run Stylelint on your styles during the build | -| [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | Minify assets, with support for several minifiers | +| Plugin | Description | +| ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | +| [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | Minify and compress assets, with support for several minifiers | +| [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) | Run ESLint, Stylelint, TypeScript, and other checkers during the build | + +## Deprecated plugins + +webpack or the plugins above now cover what these plugins did, so their +repositories are archived and they are no longer documented here. + +| Plugin | Use instead | +| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| [`mini-css-extract-plugin`](https://github.com/webpack/mini-css-extract-plugin) | [Native CSS](/guides/modern-web/native-css#3-replace-mini-css-extract-plugin) | +| [`copy-webpack-plugin`](https://github.com/webpack/copy-webpack-plugin) | The `output.copy` option, from webpack 5.111.0 | +| [`compression-webpack-plugin`](https://github.com/webpack/compression-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | +| [`css-minimizer-webpack-plugin`](https://github.com/webpack/css-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | +| [`html-minimizer-webpack-plugin`](https://github.com/webpack/html-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | +| [`image-minimizer-webpack-plugin`](https://github.com/webpack/image-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | +| [`json-minimizer-webpack-plugin`](https://github.com/webpack/json-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | +| `eslint-webpack-plugin` | [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) | +| [`stylelint-webpack-plugin`](https://github.com/webpack/stylelint-webpack-plugin) | [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) | From a2d3fe082c144371c9292c8fe71e8657d563d9ce Mon Sep 17 00:00:00 2001 From: Sameer Chore Date: Wed, 28 Oct 2026 03:15:49 +0530 Subject: [PATCH 2/3] docs: narrow the deprecated loader and plugin intros Not every deprecated loader is replaced by webpack itself, and eslint-webpack-plugin was renamed rather than archived. --- pages/docs/loaders/index.md | 4 ++-- pages/docs/plugins/index.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/docs/loaders/index.md b/pages/docs/loaders/index.md index 6d8e18f9..d4b9486c 100644 --- a/pages/docs/loaders/index.md +++ b/pages/docs/loaders/index.md @@ -24,8 +24,8 @@ The loaders below are maintained by the webpack organization. ## Deprecated loaders -webpack now covers what these loaders did, so their repositories are archived -and they are no longer documented here. +These loaders are deprecated and their repositories are archived, so they are +no longer documented here. Each one lists what to use instead. | Loader | Use instead | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | diff --git a/pages/docs/plugins/index.md b/pages/docs/plugins/index.md index 3d177599..7e39fd2f 100644 --- a/pages/docs/plugins/index.md +++ b/pages/docs/plugins/index.md @@ -20,8 +20,8 @@ The plugins below are separate packages maintained by the webpack organization. ## Deprecated plugins -webpack or the plugins above now cover what these plugins did, so their -repositories are archived and they are no longer documented here. +webpack or the plugins above now cover what these plugins did, so these +packages are deprecated and no longer documented here. | Plugin | Use instead | | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | From b8dd752a780fb577e2643f8183cb64880c041121 Mon Sep 17 00:00:00 2001 From: Sameer Chore Date: Sun, 1 Nov 2026 20:18:40 +0530 Subject: [PATCH 3/3] docs: remove the deprecated lists from the index pages Keep each index page to the single list of maintained packages, as requested in review. --- pages/docs/loaders/index.md | 15 --------------- pages/docs/plugins/index.md | 17 ----------------- 2 files changed, 32 deletions(-) diff --git a/pages/docs/loaders/index.md b/pages/docs/loaders/index.md index d4b9486c..322ffd54 100644 --- a/pages/docs/loaders/index.md +++ b/pages/docs/loaders/index.md @@ -21,18 +21,3 @@ The loaders below are maintained by the webpack organization. | [`postcss-loader`](/docs/loaders/postcss-loader) | Process CSS with PostCSS | | [`coffee-loader`](/docs/loaders/coffee-loader) | Compile CoffeeScript to JavaScript | | [`thread-loader`](/docs/loaders/thread-loader) | Run the loaders that follow it in a worker pool | - -## Deprecated loaders - -These loaders are deprecated and their repositories are archived, so they are -no longer documented here. Each one lists what to use instead. - -| Loader | Use instead | -| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| [`css-loader`](https://github.com/webpack/css-loader) | [Native CSS](/guides/modern-web/native-css#4-replace-css-loader) | -| [`style-loader`](https://github.com/webpack/style-loader) | [Native CSS](/guides/modern-web/native-css#5-replace-style-loader) | -| [`html-loader`](https://github.com/webpack/html-loader) | [`experiments.html`](/docs/api/options#experimentshtml) | -| [`exports-loader`](https://github.com/webpack/exports-loader) | A small plugin, see the [migration recipe](https://github.com/webpack/exports-loader#deprecation) | -| [`imports-loader`](https://github.com/webpack/imports-loader) | A small plugin, see the [add-imports example](https://github.com/webpack/webpack/tree/main/examples/add-imports) | -| [`expose-loader`](https://github.com/webpack/expose-loader) | A small plugin, see the [migration recipe](https://github.com/webpack/expose-loader#deprecation) | -| [`remark-loader`](https://github.com/webpack/remark-loader) | The [markdown example](https://github.com/webpack/webpack/tree/main/examples/markdown) | diff --git a/pages/docs/plugins/index.md b/pages/docs/plugins/index.md index 7e39fd2f..eed57af5 100644 --- a/pages/docs/plugins/index.md +++ b/pages/docs/plugins/index.md @@ -17,20 +17,3 @@ The plugins below are separate packages maintained by the webpack organization. | ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | Minify and compress assets, with support for several minifiers | | [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) | Run ESLint, Stylelint, TypeScript, and other checkers during the build | - -## Deprecated plugins - -webpack or the plugins above now cover what these plugins did, so these -packages are deprecated and no longer documented here. - -| Plugin | Use instead | -| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -| [`mini-css-extract-plugin`](https://github.com/webpack/mini-css-extract-plugin) | [Native CSS](/guides/modern-web/native-css#3-replace-mini-css-extract-plugin) | -| [`copy-webpack-plugin`](https://github.com/webpack/copy-webpack-plugin) | The `output.copy` option, from webpack 5.111.0 | -| [`compression-webpack-plugin`](https://github.com/webpack/compression-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | -| [`css-minimizer-webpack-plugin`](https://github.com/webpack/css-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | -| [`html-minimizer-webpack-plugin`](https://github.com/webpack/html-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | -| [`image-minimizer-webpack-plugin`](https://github.com/webpack/image-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | -| [`json-minimizer-webpack-plugin`](https://github.com/webpack/json-minimizer-webpack-plugin) | [`minimizer-webpack-plugin`](/docs/plugins/minimizer-webpack-plugin) | -| `eslint-webpack-plugin` | [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) | -| [`stylelint-webpack-plugin`](https://github.com/webpack/stylelint-webpack-plugin) | [`diagnostics-webpack-plugin`](/docs/plugins/diagnostics-webpack-plugin) |