Skip to content

docs: drop archived loaders and plugins from index pages - #292

Open
samc4e wants to merge 4 commits into
webpack:mainfrom
samc4e:docs/remove-archived-loaders-plugins
Open

samc4e wants to merge 4 commits into
webpack:mainfrom
samc4e:docs/remove-archived-loaders-plugins

Conversation

@samc4e

@samc4e samc4e commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Closes #291

Summary

scripts/markdown/readmes.mjs skips archived repositories, so no pages are generated for the loaders and plugins the webpack org has archived. The hand-written index tables still linked to them, which made 13 of the 19 links 404.

Changes

  • Loaders table: keep the 6 loaders whose repos are still active (sass, less, stylus, postcss, coffee, thread).
  • Plugins table: keep minimizer-webpack-plugin and add diagnostics-webpack-plugin (the renamed eslint-webpack-plugin).
  • New "Deprecated" sections list each archived package with its replacement, taken from the deprecation notice in its README: Native CSS, experiments.html, output.copy, minimizer-webpack-plugin, or diagnostics-webpack-plugin.

copy-webpack-plugin points to output.copy without a link, because the API reference is built from 5.109.2 and that option arrived in 5.111.0.

Before:
image

After :
Screencast from 28-10-26 02:44:45 AM IST.webm

Not in this PR

  • Some guides still link to removed pages (asset-management, production, shimming, entry-advanced, concepts/loaders, roadmap post). Updating them for native CSS/HTML is a bigger content change, so I can open a separate issue.
  • Generating the index tables from readmes.mjs would stop them drifting again. Happy to do that in a follow-up if you want it.

Testing

  • Ran npm run build. All internal links and anchors on both index pages resolve in out/.
  • npm run format:check and npm run lint pass.

Use of AI
yes antigravity used ,for tracing the archived repository of specific plugin.

Summary by CodeRabbit

  • Documentation
    • Updated the loader and plugin tables. The loader table no longer lists css-loader, style-loader, html-loader, exports-loader, imports-loader, or expose-loader.
    • The plugin table now lists minimizer-webpack-plugin and diagnostics-webpack-plugin, and no longer lists mini-css-extract-plugin, copy-webpack-plugin, compression-webpack-plugin, image-minimizer-webpack-plugin, eslint-webpack-plugin, or stylelint-webpack-plugin.
    • Updated the author credits on both 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 webpack#291
@vercel

vercel Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
webpack-doc-kit Ready Ready Preview Nov 1, 2026 2:50pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ⚠️ Failed 2026-10-27T21:39:32.800487Z
We couldn’t complete this review. Comment @codex review to try again.
5ba2aae PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Oct 27, 2026
@coderabbitai

coderabbitai Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 017cedcb-4473-4651-8190-c63d7a5acf59
Commits

Reviewing files that changed from the base of the PR and between bcd2027 and b8dd752.

Files selected for processing: 2
  • pages/docs/loaders/index.md
  • pages/docs/plugins/index.md
Files with no reviewable changes: 2
  • pages/docs/loaders/index.md
  • pages/docs/plugins/index.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Walkthrough

The loader and plugin index pages add an author credit. The loader table removes six entries. The plugin table retains minimizer-webpack-plugin, expands its description to include compression, and adds diagnostics-webpack-plugin. The plugin table also removes six entries.

Severity of issue fixed: Low

Merge Risk: Minimal · up to b8dd7

The catalog updates have no identified issue requiring a fix before merge.

Pre-merge checks: Passed 4 · Inconclusive 1

Failed Failed checks: 1 inconclusive

Check name Status Explanation Resolution
Out of Scope Changes check Inconclusive The changes stay in the two index pages and follow the goal of #291. Two points lack evidence. (1) The plugins table removes mini-css-extract-plugin, copy-webpack-plugin, compression-webpack-plugin, i… Confirm the archive status of each removed plugin and loader repository, for example from the GitHub repository settings or org repository list. If an entry is not archived, restore its row. Update the PR description so that it matches head…
Passed Passed checks: 4 passed
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly and concisely describes the main change: removing archived loaders and plugins from the documentation index pages.
Linked Issues check Passed [#291] Requirement: the loaders and plugins index pages must not link to deprecated or archived repositories whose generated pages return 404. At head, pages/docs/loaders/index.md keeps 6 loader links…
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
Full details: Linked Issues check

Explanation

[#291] Requirement: the loaders and plugins index pages must not link to deprecated or archived repositories whose generated pages return 404. At head, pages/docs/loaders/index.md keeps 6 loader links (sass, less, stylus, postcss, coffee, thread) and removes the other 6 (css, style, html, exports, imports, expose). pages/docs/plugins/index.md keeps minimizer-webpack-plugin and adds diagnostics-webpack-plugin, and removes 6 entries. scripts/markdown/readmes.mjs skips repos where repo.archived is true, so pages exist only for non-archived org repos. The kept links therefore target generated pages. The change is docs-only and has no automated test. The removed links are no longer present. Archive status of the live repositories was not independently checked, because the tools cannot query GitHub. The PR description's 'Deprecated' sections and replacement guidance do not appear at head. They are not a requirement of #291, so this does not change the result.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (2 skipped: 2 unsupported.)

Full details: Out of Scope Changes check

Explanation

The changes stay in the two index pages and follow the goal of #291. Two points lack evidence. (1) The plugins table removes mini-css-extract-plugin, copy-webpack-plugin, compression-webpack-plugin, image-minimizer-webpack-plugin, eslint-webpack-plugin, and stylelint-webpack-plugin. The PR description names replacements only for copy, eslint, and some others. It does not state that mini-css-extract-plugin is archived, and the script filter alone cannot show that. Removing an active, non-archived package would exceed #291, which covers only deprecated or archived repositories. (2) The PR description says 'Deprecated' sections with replacements were added. The head diff contains no such sections, so the description does not match the code. The author credit change (samc4e) is minor metadata for the same pages and is not treated as unrelated.

Resolution

Confirm the archive status of each removed plugin and loader repository, for example from the GitHub repository settings or org repository list. If an entry is not archived, restore its row. Update the PR description so that it matches head. State the replacement guidance that is kept or dropped for each removed package. Then reassess this check.

Finishing Touches
Generate unit tests (beta)
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2


Review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: c50d30d8-4538-4f02-974c-25433c23ee84
Commits

Reviewing files that changed from the base of the PR and between 26b3491 and 5ba2aae.

Files selected for processing: 2
  • pages/docs/loaders/index.md
  • pages/docs/plugins/index.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Comment thread pages/docs/loaders/index.md Resolved
Comment thread pages/docs/plugins/index.md Resolved
Not every deprecated loader is replaced by webpack itself, and
eslint-webpack-plugin was renamed rather than archived.
@samc4e

samc4e commented Oct 28, 2026

Copy link
Copy Markdown
Contributor Author

@ryzrr PTAL

@ryzrr

ryzrr commented Oct 29, 2026

Copy link
Copy Markdown
Member
image i think we dont need to mention the deprecated list on the index page

@samc4e

samc4e commented Oct 31, 2026

Copy link
Copy Markdown
Contributor Author

image i think we dont need to mention the deprecated list on the index page

okay I will make it in single list

Keep each index page to the single list of maintained packages, as
requested in review.

@ryzrr ryzrr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

This branch was successfully deployed

1 active deployment
Preview — b8dd752a Deployed Nov 1, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Loaders and Plugin index page links to deprecated/removed repos (404)

2 participants