From 954890a42f143896d5892066f7b5a0f2b120fbfe Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Thu, 21 Sep 2023 02:52:05 +0200 Subject: [PATCH 1/3] add information on release cycle and backports --- doc/manual/src/release-notes/release-notes.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/manual/src/release-notes/release-notes.md b/doc/manual/src/release-notes/release-notes.md index b05d5ee0a..dbda0babd 100644 --- a/doc/manual/src/release-notes/release-notes.md +++ b/doc/manual/src/release-notes/release-notes.md @@ -1 +1,7 @@ # 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. + +Bugfixes can be backported on request to 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). + From 1b560ea502cf0308b829e4b3425307f80fc3528a Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Thu, 21 Sep 2023 23:23:14 +0200 Subject: [PATCH 2/3] more detail on backports Co-authored-by: John Ericson --- doc/manual/src/release-notes/release-notes.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/manual/src/release-notes/release-notes.md b/doc/manual/src/release-notes/release-notes.md index dbda0babd..1fa2f5580 100644 --- a/doc/manual/src/release-notes/release-notes.md +++ b/doc/manual/src/release-notes/release-notes.md @@ -3,5 +3,9 @@ Nix has a release cycle of roughly 6 weeks. Notable changes and additions are announced in the release notes for each version. -Bugfixes can be backported on request to 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). +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). + +Backports never skip releases (if a feature is backported to `x.y`, it must also be available in `x.(y+1)`; +This ensures that upgrading from an older version with backports is still safe and no backported functionality will go missing. From a757749fcfa810f699fa096f98821efccba86522 Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Tue, 26 Sep 2023 06:28:17 +0200 Subject: [PATCH 3/3] reword for readability --- doc/manual/src/release-notes/release-notes.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/manual/src/release-notes/release-notes.md b/doc/manual/src/release-notes/release-notes.md index 1fa2f5580..cc805e631 100644 --- a/doc/manual/src/release-notes/release-notes.md +++ b/doc/manual/src/release-notes/release-notes.md @@ -6,6 +6,7 @@ Notable changes and additions are announced in the release notes for each versio 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). -Backports never skip releases (if a feature is backported to `x.y`, it must also be available in `x.(y+1)`; +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.