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
  • [x] Ad hoc shell environments
  • [x] Reproducible interpreted scripts
  • [ ] Declarative shell environments
  • https://github.com/NixOS/nix.dev/issues/516
• 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
  • [ ] Setting up a binary cache
  • [ ] Setting up distributed builds
  • [ ] Cross compilation
  • [x] 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:

• https://github.com/NixOS/nix.dev/issues/750
• https://github.com/NixOS/nix.dev/issues/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

[zmitchell]

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 🤦‍♂️

[zmitchell]

Fixed

[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