nix.dev/maintainers/working_groups/learning_journey/documentation-survey.md

Documentation survey

To better navigate the material and judge its relevance, every entry should provide

• Title (URL)
• Brief summary
• Video length or estimated reading time
• Principal Author(s)
• Year created (last update or maintenance status)

Tutorials

Nix

• Nix Pills Chapter 3: Enter the Environment

  Installation with nix-env, rollback and switching generations, showing references and closures.

  • Reading time: 7 min
  • Author: Luca Bruno
  • Created: 2015 (effectively unmaintained since 2017)

• Nix Pills Chapter 6. Our First Derivation

  Fundamentals of Nix derivations, function and concept, nix show-derivation. Derivation set and its attributes.

  • Reading time: 20 min
  • Author: Luca Bruno
  • Created: 2015 (effectively unmaintained since 2017)

• Nix Pills Chapter 7. Working Derivation

  Fundamentals of Nix derivations, bash, nix repl, nix-store, nix-instantiate, nix show-derivation . Packaging a simple C program, inherit keyword.

  • Reading time: 16 min
  • Author: Luca Bruno
  • Created: 2015 (effectively unmaintained since 2017)

• Nix Pills Chapter 11. Garbage Collector Fundamentals of Nix garbage collection, nix-collect-garbage, nix-env, nix-store, nix-build.

  • Reading time: 14 min
  • Author: Luca Bruno
  • Created: 2015 (effectively unmaintained since 2017)

• https://nixos.org/guides/nix-pills/nix-search-paths.html

• https://nixos.org/guides/nix-pills/nix-store-paths.html

Nix language

• https://learnxinyminutes.com/docs/nix/
• https://nixcloud.io/tour/?id=1
• https://medium.com/@MrJamesFisher/nix-by-example-a0063a1a4c55
• https://www.youtube.com/watch?v=eCapIx9heBw&list=PL-saUBvIJzOkjAw_vOac75v-x6EzNzZq-&index=5
• https://nixos.org/guides/nix-pills/basics-of-language.html
• https://nixos.org/guides/nix-pills/functions-and-imports.html

Nixpkgs

• https://www.youtube.com/watch?v=SGekN4pDExY&list=PL-saUBvIJzOkjAw_vOac75v-x6EzNzZq-&index=6
• https://www.youtube.com/watch?v=m4sv2M9jRLg
• https://nixos.org/guides/nix-pills/generic-builders.html
• https://nixos.org/guides/nix-pills/automatic-runtime-dependencies.html
• https://nixos.org/guides/nix-pills/developing-with-nix-shell.html
• https://nixos.org/guides/nix-pills/inputs-design-pattern.html
• https://nixos.org/guides/nix-pills/callpackage-design-pattern.html
• https://nixos.org/guides/nix-pills/override-design-pattern.html
• https://nixos.org/guides/nix-pills/nixpkgs-parameters.html
• https://nixos.org/guides/nix-pills/nixpkgs-overriding-packages.html
• https://nixos.org/guides/nix-pills/fundamentals-of-stdenv.html
• https://nixos.org/guides/nix-pills/basic-dependencies-and-hooks.html

NixOS

• https://www.youtube.com/watch?v=jf0nIn2oS8A&list=PL-saUBvIJzOkjAw_vOac75v-x6EzNzZq-&index=4

How-To Guides

Nix

• https://nix.dev/tutorials/ad-hoc-developer-environments#what-is-a-shell-environment
• https://nixos.wiki/wiki/Nix_Cookbook#Managing_storage

Nix language

• https://nix.dev/anti-patterns/language.html

Nixpkgs

• https://nixos.wiki/wiki/FAQ
• https://www.youtube.com/watch?v=D_IZ2EfW_8U
• https://www.youtube.com/watch?v=5K_2RSjbdXc
• https://www.youtube.com/watch?v=dGAL3gMXvug
• https://nix.dev/tutorials/towards-reproducibility-pinning-nixpkgs
• https://nix.dev/tutorials/declarative-and-reproducible-developer-environments
• https://nix.dev/tutorials/cross-compilation.html
• https://nixos.org/manual/nixpkgs/stable

NixOS

• https://nix.dev/tutorials/building-bootable-iso-image.html
• https://nix.dev/tutorials/deploying-nixos-using-terraform.html
• https://nix.dev/tutorials/installing-nixos-on-a-raspberry-pi.html
• https://www.youtube.com/watch?v=bkDYmvKINm8
• https://www.youtube.com/watch?v=Zi_vbddNXtg
• https://github.com/noteed/nix-notes
• https://nixos.org/manual/nixos/stable/

Explanation

Nix

• https://nixos.org/guides/nix-pills/index.html
• partially in chapter https://nixos.org/guides/nix-pills/automatic-runtime-dependencies.html
• https://nixos.org/guides/nix-pills/garbage-collector.html
• https://edolstra.github.io/pubs/phd-thesis.pdf

Nix language

• https://edolstra.github.io/pubs/phd-thesis.pdf

Nixpkgs

• https://nixos.org/guides/nix-pills/index.html
• partially in chapter https://nixos.org/guides/nix-pills/our-first-derivation.html
• https://nixos.org/guides/nix-pills/working-derivation.html
• https://nixos.org/guides/nix-pills/inputs-design-pattern.html
• https://nixos.org/guides/nix-pills/callpackage-design-pattern.html
• https://nixos.org/guides/nix-pills/callpackage-design-pattern.html
• partially in https://edolstra.github.io/pubs/phd-thesis.pdf
• https://www.zombiezen.com/blog/2023/03/connecting-bash-to-nix/

NixOS

• https://nixos.org/docs/SCR-2005-091.pdf (2006)

Reference

Nix

• https://nixos.org/manual/nix/stable/command-ref/command-ref.html
• https://edolstra.github.io/pubs/phd-thesis.pdf

Nix language

• https://edolstra.github.io/pubs/phd-thesis.pdf
• https://nixos.org/manual/nix/stable/expressions/writing-nix-expressions.html
• https://github.com/tazjin/nix-1p

Nixpkgs

• https://nixos.org/manual/nixpkgs/stable

NixOS

• https://nixos.org/manual/nixos/stable