Tutorials overview

[zmitchell]

This tracking issue is an outline of tutorials we've decided to make for the Learning Journey, in context of the 2023 documentation project. Some experimentation has been done in #701.

Tutorials that aren't checked off and don't have an associated issue already exist but need a revision.

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
  • Setting up distributed builds
  • Cross compilation
  • Integration testing with NixOS virtual machines
  • 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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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

[nixos-discourse]

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