Skip to content

Commit

Permalink
add update instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
fricklerhandwerk committed Nov 13, 2023
1 parent 1075103 commit 3294d19
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,23 @@ Adapted from the [Contributor Covenant] and [The Carpentries Code of Conduct]:
[Contributor Covenant]: https://github.com/EthicalSource/contributor_covenant/blob/cd7fcf684249786b7f7d47ba49c23a6bcb3233eb/content/version/2/1/code_of_conduct.md
[The Carpentries Code of Conduct]: https://github.com/carpentries/docs.carpentries.org/blob/4691971d9f49544054410334140a4fd391a738da/topic_folders/policies/code-of-conduct.md

## Updating reference manuals

With the current setup, the Nix manual hosted on nix.dev does not get updated automatically with new releases.
The following manual steps are required:

- Update the inputs to use the latest versions of the Nix release branches with `nix flake lock`
- Make sure Nix can be fetched from the cache, otherwise it has to be rebuild.
If it doesn't, find the latest commit that is [built by Hydra](https://hydra.nixos.org/project/nix).
- On each new Nix release, update the latest version in [`flake.nix`](./flake.nix) and [`source/reference/nix-manual.md`](./source/reference/nix-manual.md).
- If Nixpkgs unstable or a NixOS stable release adopt a new version of Nix, update the corresponding references here.

Also update URLs to the the Nix manual to the version used by Nixpkgs unstable.
For example, if one wants to move from 2.18 to 2.19:
```bash
sed -i 's#https://nix.dev/manual/nix/2.18/#https://nix.dev/manual/nix/2.19/#g' $(ls **/*.md)
```

## What you can do

### You want to learn and use Nix?
Expand Down

0 comments on commit 3294d19

Please sign in to comment.