Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TODO: mention nixos-option and nixos.org/nixos/options.html in manual Chapter 6 #77959

Closed
trusktr opened this issue Jan 18, 2020 · 1 comment · Fixed by #77960
Closed

TODO: mention nixos-option and nixos.org/nixos/options.html in manual Chapter 6 #77959

trusktr opened this issue Jan 18, 2020 · 1 comment · Fixed by #77960

Comments

@trusktr
Copy link

trusktr commented Jan 18, 2020

We should mention in nixos manual Chapter 6 that options can be dicovered with nix-option and http://nixos.org/nixos/options.html. It will help newbs learn how to discover packages more easily.

As a new user, I was sticking everything I wanted inside of the systemPackages array, and I didn't not realize that programs.foo.enable is a better route to take because it configures many things automatically. For example, programs.zsh.enable = true results in nix-zsh-completions also being installed as well as features enabled, while writing environment.systemPackages = [pkgs.zsh] does not.

This will be helpful to new users.

@nixos-discourse
Copy link

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/programs-foo-enable-true-vs-systempackages-foo-is-confusing/5534/7

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants