Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions pages/about/versioning.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
title: Version Support
---

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.

Just a reminder, we can add frontmatter tags (.e.g, author, source, layout).


# Version Support

webpack follows a **current + maintenance** support model:

- **Current** — The latest major release line. Receives new features, bug fixes, and security fixes.
- **Maintenance** — The single major release line immediately preceding the current one. Receives bug fixes and security fixes only. A version enters maintenance as soon as the next major version is released.
- **End-of-Life (EOL)** — Everything older than the maintenance line. When a new major version is released, the version previously in maintenance becomes EOL.

## Support Table

| Major Version | Minimum Node.js Version | Release Date | Status | EOL Date |
| ------------------------------------------------------------- | ----------------------- | ------------- | --------------- | ------------- |
| [**v5.x**](https://github.com/webpack/webpack) | v10.13.0 | October 2020 | **Current** | — |
| [**v4.x**](https://github.com/webpack/webpack/tree/webpack-4) | v6.11.5 | February 2018 | **Maintenance** | — |

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.

Is it actually still maintained? I'd say it's effectively EOL. It hasn't received bug fixes for a while, and I don't expect it to receive any. The only reason it hasn't been deprecated on npm is to avoid the noise that would create.

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.

I know you explain it further down, but I think we should define those things more clearly.

| **v3.x** | v4.3.0 | June 2017 | EOL | February 2018 |
| **v2.x** | v4.3.0 | January 2017 | EOL | June 2017 |
| **v1.x** | v0.6.0 | February 2014 | EOL | January 2017 |

A version in **Maintenance** remains there until the next major version of webpack is released, at which point it becomes EOL and the outgoing Current version takes its place. For example, when webpack 6 is released, v5.x will move to Maintenance and v4.x will reach EOL.

## EOL Policy

EOL versions of webpack are unsupported. The webpack team does **not** plan to address, patch, or release fixes for any issues found in EOL versions — including security vulnerabilities.

In rare circumstances, at its sole discretion, the team _may_ choose to backport a fix for a critical security vulnerability to an EOL version. This is an exception, not a policy: **do not rely on it, and do not plan around or for it.** If you are running an EOL version, the only supported remediation for any issue is upgrading to a supported release line or rely on third-party commercial support providers.

Issues and pull requests filed against EOL versions will be closed.

## Release Schedule

webpack does not publish release timelines. There is **no ETA** for:

- The release date of any future major version (including webpack 6), or
- The date on which the current version will transition to Maintenance.

Rather, major versions ship when they are ready.
1 change: 1 addition & 0 deletions pages/site.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ export const sidebar = {
items: [
{ link: '/about/branding', label: 'Branding' },
{ link: '/about/sponsors', label: 'Sponsors' },
{ link: '/about/versioning', label: 'Version Support' },
{
link: 'https://github.com/webpack/webpack/blob/main/CONTRIBUTING.md',
label: 'Contribute',
Expand Down
Loading