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
  • [x] Ad hoc shell environments
  • [x] Reproducible interpreted scripts
  • [ ] Declarative shell environments
    • https://github.com/NixOS/nix.dev/issues/516
• [x] Nix language basics
• Customisable packages
  • [ ] https://github.com/NixOS/nix.dev/issues/116
  • [x] Packaging existing software
  • [ ] https://github.com/NixOS/nix.dev/issues/603
  • [x] https://github.com/NixOS/nix.dev/issues/651
  • [x] Working with local files
  • [ ] Debugging builds
• https://github.com/NixOS/nix.dev/issues/579
• Declarative configurations
  • [ ] Module system basics
  • [ ] https://github.com/NixOS/nix.dev/issues/129
  • [ ] Editor configuration with Home Manager (Neovim, Emacs, VS Code)
  • [ ] Declarative macOS configuration (with nix-darwin)
  • [ ] Declarative Linux configuration (with system-manager)
  • [x] NixOS in a virtual machine
  • [ ] https://github.com/NixOS/nix.dev/issues/738
  • [ ] NixOS on a Raspberry Pi
• Module system deep dive
• Build, test, and deploy software
  • [x] #1012
  • [ ] #1013
  • [ ] Cross compilation
  • [x] Integration testing with NixOS virtual machines
  • [x] #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:

• https://github.com/NixOS/nix.dev/issues/750
• https://github.com/NixOS/nix.dev/issues/845

How you can help

• Tell us what's important to you, by adding :+1: 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

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-05-25-learning-journey-working-group-meeting-notes-10/28481/2

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-06-01-learning-journey-working-group-meeting-notes-11/28829/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-06-08-learning-journey-working-group-meeting-notes-12/29084/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-06-15-learning-journey-working-group-meeting-notes-13/29333/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-06-22-learning-journey-working-group-meeting-notes-14/29490/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-08-03-learning-journey-working-group-meeting-notes-20/31251/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-09-31-documentation-team-meeting-notes-77/32497/1

I'm only just now realizing that all of these issues call their tutorials "First steps tutorial"s even though we already have a "First steps" section and the tutorial is actually meant to go in the "Learning Journey" section 🤦‍♂️

Fixed

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2024-02-22-documentation-team-meeting-notes-110/40145/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2024-04-15-documentation-team-meeting-notes-119/43432/1

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/do-you-know-of-any-freely-licensed-1-hour-nix-bootcamp-trainer-curricula/44791/2