Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the release cycle #10288

Merged
merged 3 commits into from
Apr 5, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
2 changes: 1 addition & 1 deletion doc/manual/src/SUMMARY.md.in
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@
- [Experimental Features](contributing/experimental-features.md)
- [CLI guideline](contributing/cli-guideline.md)
- [C++ style guide](contributing/cxx.md)
- [Release Notes](release-notes/index.md)
- [Releases](release-notes/index.md)
{{#include ./SUMMARY-rl-next.md}}
- [Release 2.21 (2024-03-11)](release-notes/rl-2.21.md)
- [Release 2.20 (2024-01-29)](release-notes/rl-2.20.md)
Expand Down
17 changes: 10 additions & 7 deletions doc/manual/src/release-notes/index.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,15 @@
# Nix Release Notes

Nix has a release cycle of roughly 6 weeks.
Notable changes and additions are announced in the release notes for each version.
The Nix release cycle is calendar-based as follows:

- A new minor version (`XX.YY+1.0`) is published every month and supported for two months;
- A new major version (`XX+1.1.0`) is published twice a year, in April and October, and supported for eight months.
Copy link
Member

Choose a reason for hiding this comment

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

I don't understand what this means. What are XX and YY? Year and month? And what do the +1.0 and +1.1.0 denote?


Bugfixes can be backported on request to previous Nix releases.
We typically backport only as far back as the Nix version used in the latest NixOS release, which is announced in the [NixOS release notes](https://nixos.org/manual/nixos/stable/release-notes.html#ch-release-notes).
The rationale behind that cycle is that
- Minor versions stay close to master and bring early access to new features for the user who need them;
- Major versions are aligned with the NixOS releases (released one month before NixOS and supported for as long at it).

Backports never skip releases.
If a feature is backported to version `x.y`, it must also be available in version `x.(y+1)`.
This ensures that upgrading from an older version with backports is still safe and no backported functionality will go missing.
Bugfixes and security issues are backported to every supported version.
Patch releases are published as needed.

Notable changes and additions are announced in the release notes for each version.
Loading