Currently the following guides exist:
- Nix reference guide
- NixOS reference guide
- Hydra reference guide
- Nixpkgs guide
as well as a (mostly outdated) read-only wiki.
What is missing is introductory material. There are also complaints that the current tooling used for the guides hinders contributing. Contributions to the guides are currently peer-reviewed, and we should maintain that to keep the quality high.
I propose we create the following guides:
- Nix reference guide
- NixOS reference guide
- Hydra reference guide
- Nix user guide -
- Nixpkgs contributor guide
The Nix reference guide should provide an overview and technical details of the Nix package manager and language.
The NixOS reference guide should provide an overview and technical details of NixOS (and thus also the concept of modules).
The NixOS reference guide should provide an overview and technical details of the Hydra software, and not the service https://hydra.nixos.org.
The Nix users guide will be the main guide for Nix users. The guide should provide introductory material as well as reference material.
- Introduction to
- Nix ecosystem
- Nix package manager
- Nixpkgs
- Nixpkgs Hydra
- NixOS
- Hydra (NOT https://hydra.nixos.org.)
- Python on Nix
- Haskell on Nix
- ...
- Reference
- Python
- buildPythonPackage
- Haskell
The Nixpkgs contributor guide contains details about Nixpkgs style and how to contribute.