From 72c6a69e6bc19788428eb0b182242bd27d7e61ab Mon Sep 17 00:00:00 2001 From: Moritz Heidkamp Date: Wed, 8 Jan 2025 15:52:08 +0100 Subject: [PATCH] nixos/doc/manual/installation: improve explanation of when channels are updated The phrasing that channels are updated automatically "[when] all packages have been built" could be read as "all packages have been built successfully". However, in reality, it only meant to say that all packages have been *attempted* to be built, so a channel may still contain broken packages. This patch aims to make this clearer by mentioning that only a selection of packages is required to be built successfully and by pointing to the files which contain these selections. --- nixos/doc/manual/installation/upgrading.chapter.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/nixos/doc/manual/installation/upgrading.chapter.md b/nixos/doc/manual/installation/upgrading.chapter.md index 91fd5f90cc46..6622c983047b 100644 --- a/nixos/doc/manual/installation/upgrading.chapter.md +++ b/nixos/doc/manual/installation/upgrading.chapter.md @@ -4,7 +4,9 @@ The best way to keep your NixOS installation up to date is to use one of the NixOS *channels*. A channel is a Nix mechanism for distributing Nix expressions and associated binaries. The NixOS channels are updated automatically from NixOS's Git repository after certain tests have -passed and all packages have been built. These channels are: +passed and a selection of packages has been built successfully +(see `nixos/release-combined.nix` and `nixos/release-small.nix`). +These channels are: - *Stable channels*, such as [`nixos-25.05`](https://channels.nixos.org/nixos-25.05). These only get conservative bug fixes and package upgrades. For