docs(nix-style): clarify Home Manager package ownership

This commit is contained in:
2026-10-11 17:31:43 -04:00
parent 81a0e0ab76
commit 070fdf2a99
2 changed files with 6 additions and 3 deletions

View File

@@ -41,13 +41,13 @@ They also make package ownership explicit.
### Rule
Use `pkgs.<name>` for Home Manager tools when Home Manager uses global NixOS packages.
Use `pkgs.<name>` for Home Manager tools.
Use `config.programs.<name>.package` when a NixOS module owns the selected package.
Do not read `config.home-manager.users.<user>.programs.<name>.package` for command paths.
Use that Home Manager package option only when Home Manager intentionally selects a different package.
Home Manager uses the NixOS package set in this repository.
### Rationale
Most Home Manager modules in this repository share the NixOS package set.
Home Manager uses the NixOS package set in this repository.
Referencing `pkgs.<name>` avoids needless dependency paths through the Home Manager user tree.
Configured NixOS package options preserve the selected package when a module owns the tool.