pyrox.dev / nixpkgs
lol
fork atom

doc: consistently use `nixpkgs-unstable` and "nixpkgs repository"

Rename channel `nixpkgs` to `nixpkgs-unstable`. Based on the
[repo branches](https://github.com/NixOS/nixpkgs/branches)
and [channel status](https://status.nixos.org) I don't believe there is
a `nixpkgs` channel. This confused me as a Nixpkgs beginner.
Rename to `nixpkgs-unstable`, which does exist.

Refer to "nixpkgs repository" consitently. Make the capitalization and
"code quoting" consistent when referring to the repository itself.

Chris Pick e78516b9 8cc42008

options
unified split
Changed files
+6 -6
doc
preface.chapter.md
+6 -6
doc/preface.chapter.md 
···

       
27

       
 

       
Packages, including the Nix packages collection, are distributed through


     

       
28

       
 

       
[channels](https://nixos.org/nix/manual/#sec-channels). The collection is


     

       
29

       
 

       
distributed for users of Nix on non-NixOS distributions through the channel


     

       
30

       
-

       
`nixpkgs`. Users of NixOS generally use one of the `nixos-*` channels, e.g.


     

       
31

       
-

       
`nixos-22.11`, which includes all packages and modules for the stable NixOS


     

       
32

       
 

       
22.11. Stable NixOS releases are generally only given


     

       
33

       
 

       
security updates. More up to date packages and modules are available via the


     

       
34

       
 

       
`nixos-unstable` channel.


     

       
35

       
 

       



     

       
36

       
-

       
Both `nixos-unstable` and `nixpkgs` follow the `master` branch of the Nixpkgs


     

       
37

       
-

       
repository, although both do lag the `master` branch by generally


     

       
38

       
 

       
[a couple of days](https://status.nixos.org/). Updates to a channel are


     

       
39

       
 

       
distributed as soon as all tests for that channel pass, e.g.


     

       
40

       
 

       
[this table](https://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents)


     

       
41

       
-

       
shows the status of tests for the `nixpkgs` channel.


     

       
42

       
 

       



     

       
43

       
 

       
The tests are conducted by a cluster called [Hydra](https://nixos.org/hydra/),


     

       
44

       
 

       
which also builds binary packages from the Nix expressions in Nixpkgs for


     
···

       
46

       
 

       
The binaries are made available via a [binary cache](https://cache.nixos.org).


     

       
47

       
 

       



     

       
48

       
 

       
The current Nix expressions of the channels are available in the


     

       
49

       
-

       
[`nixpkgs`](https://github.com/NixOS/nixpkgs) repository in branches


     

       
50

       
 

       
that correspond to the channel names (e.g. `nixos-22.11-small`).


     
···

       
27

       
 

       
Packages, including the Nix packages collection, are distributed through


     

       
28

       
 

       
[channels](https://nixos.org/nix/manual/#sec-channels). The collection is


     

       
29

       
 

       
distributed for users of Nix on non-NixOS distributions through the channel


     

       
30

       
+

       
`nixpkgs-unstable`. Users of NixOS generally use one of the `nixos-*` channels,


     

       
31

       
+

       
e.g. `nixos-22.11`, which includes all packages and modules for the stable NixOS


     

       
32

       
 

       
22.11. Stable NixOS releases are generally only given


     

       
33

       
 

       
security updates. More up to date packages and modules are available via the


     

       
34

       
 

       
`nixos-unstable` channel.


     

       
35

       
 

       



     

       
36

       
+

       
Both `nixos-unstable` and `nixpkgs-unstable` follow the `master` branch of the


     

       
37

       
+

       
nixpkgs repository, although both do lag the `master` branch by generally


     

       
38

       
 

       
[a couple of days](https://status.nixos.org/). Updates to a channel are


     

       
39

       
 

       
distributed as soon as all tests for that channel pass, e.g.


     

       
40

       
 

       
[this table](https://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents)


     

       
41

       
+

       
shows the status of tests for the `nixpkgs-unstable` channel.


     

       
42

       
 

       



     

       
43

       
 

       
The tests are conducted by a cluster called [Hydra](https://nixos.org/hydra/),


     

       
44

       
 

       
which also builds binary packages from the Nix expressions in Nixpkgs for


     
···

       
46

       
 

       
The binaries are made available via a [binary cache](https://cache.nixos.org).


     

       
47

       
 

       



     

       
48

       
 

       
The current Nix expressions of the channels are available in the


     

       
49

       
+

       
[nixpkgs repository](https://github.com/NixOS/nixpkgs) in branches


     

       
50

       
 

       
that correspond to the channel names (e.g. `nixos-22.11-small`).