This tracking issue is an outline of tutorials we want to present on nix.dev, originally designed in the 2023 documentation project "Learning Journey". It is continuously updated as we better understand how beginners approach the Nix ecosystem.

Please check existing tutorial requests before submitting new proposals.

Outline

• Temporary environments
  • Ad hoc shell environments
  • Reproducible interpreted scripts
  • Declarative shell environments
    • Nix language primer with shell.nix #516
• Nix language basics
• Customisable packages
  • Overlays #116
  • Packaging existing software
  • Build phases (with mkDerivation) #603
  • Package parameters and overrides (with callPackage) #651
  • Working with local files
  • Debugging builds
• Nix language deep dive (with nix repl) #579
• Declarative configurations
  • Module system basics
  • Declarative user environments (with Home Manager) #129
  • Editor configuration with Home Manager (Neovim, Emacs, VS Code)
  • Declarative macOS configuration (with nix-darwin)
  • Declarative Linux configuration (with system-manager)
  • NixOS in a virtual machine
  • Install NixOS #738
  • NixOS on a Raspberry Pi
• Module system deep dive
• Build, test, and deploy software
  • Setting up a binary cache #1012
  • Setting up distributed builds #1013
  • Cross compilation
  • Integration testing with NixOS virtual machines
  • Provisioning remote machines #1014
  • Continuous integration with GitHub Actions
  • Remote NixOS installation (with nixos-anywhere)
  • Build and run NixOS containers
  • Build and run Docker images
  • Deploy NixOS using Terraform

Other tasks:

• Move the pinning overview to the Nix manual #750
• Put "Best practices" parts where they belong #845

How you can help

• Tell us what's important to you, by adding 👍 on issues for tutorials that you would like to get addressed.
• If you find helpful, freely licensed tutorials, open an issue

support the Nix documentation team on Open Collective to help