2019-01-28 15:09:08 +00:00
## Release Plan
Starting with version `v2.4` , Nuxt will adhere to a formalized release plan (as good as possible).
2019-12-04 15:29:53 +00:00
Also, an end of life for older major versions is defined with this document.
2019-01-28 15:09:08 +00:00
### Major versions (3.x -> 4.0)
Nuxt major releases are planned every **6 months** . This depends on a few factors though:
2019-12-04 15:29:53 +00:00
- If there are no breaking changes waiting for a release, no new major version will be published. Instead, another minor one will be released
- In case of unexpected major updates of important dependencies like Vue, Webpack, and so on, major versions might be released _earlier_ than planned
2019-01-28 15:09:08 +00:00
The goal is to provide a **migration guide** for each major version as well, as escape hatches, so existing code
won't "just break".
### Minor versions (2.1 -> 2.2)
2020-11-30 22:44:04 +00:00
The release cycle for Nuxt minor versions is roughly **4 weeks** .
2019-01-28 15:09:08 +00:00
2019-12-04 15:29:53 +00:00
Three of the four weeks will be used for actual **feature implementations** while the last week will be used for
2019-01-28 15:09:08 +00:00
**testing, fixing bugs and thorough audits**.
2019-12-04 15:29:53 +00:00
That also means a _feature freeze_ for the next minor version after these three weeks.
Features that aren't ready will be moved to the next cycle. "Waiting" for features
2019-01-28 15:09:08 +00:00
(for a longer time) will be avoided as good as possible to keep releases lean, concise, predictable and digestible.
### Patch releases (2.2.3 -> 2.2.4)
2019-12-04 15:29:53 +00:00
The last patch releases were mostly _bundled_ fixes or single _hotfixes_ .
In the future, fixes will be released **as soon as possible** after the actual PR/commit so people won't have to switch to `nuxt-edge` for bugfixes. This should improve the stability of Nuxt.
2019-01-28 15:09:08 +00:00
Fixes can or will include:
2020-11-30 22:44:04 +00:00
- Updates of dependencies (for various reasons, like a "faulty/buggy" dependency or an newer versions that works better with the Nuxt code)
2019-12-04 15:29:53 +00:00
- Fixes for our code
2019-01-28 15:09:08 +00:00
Bugfixes for upcoming features won't be ported of course.
### Edge Release Channel
2020-04-14 09:26:40 +00:00
After experimenting with `nuxt-edge` releases in the last time, the decision to do **nightly releases** for now instead of
2019-12-04 15:29:53 +00:00
releasing a version after _each commit_ was made.
2019-01-28 15:09:08 +00:00
## End of Life
2020-11-30 22:44:04 +00:00
Starting with `v2.4` , every major Nuxt version will have an **End of Life** .
2019-12-04 15:29:53 +00:00
Previous releases will receive security updates and bugfixes **for one year and two weeks** , counted from the first release on.
2020-11-30 22:44:04 +00:00
As Nuxt majors are approximately released once every 6 months, this will allow developers to "skip one major version" without being stuck with a broken or unsecure Nuxt dependency.
2019-01-28 15:09:08 +00:00
The EOL also applies to the documentation.
