Guides and Recipes overview

[fricklerhandwerk]

This tracking issue is to keep an overview of guides for most common use cases.

• Dependency management with npins (with Home Manager)
• Automatic environments with direnv (with Home Manager)
• Package scaffolding (with nix-init)
• Building a bootable NixOS ISO image
• Running pre-built binaries on NixOS
• Nix post-build hooks #463
• Using a specific package version #490
• Managing secrets (no optimal solution)
• Overview of package customisation #731
• Overview of pinning techniques #907 (no optimal solution)

Guides should complement the tutorials, and should be quite short. They can even duplicate important topics to have a condensed form for quick lookup. Related: #910

A good example is the guide on sharing dependencies with shell.nix. It starts with a very small sample to show the pattern (which requires some proficiency with the Nix language to grasp quickly), and expands on the details below the fold.

[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