Why is allowUnfree needed?

[louwers]

Could you document why allowUnfree is needed?

[freeman42x]

I am not sure how deep the rabbit hole we should go with duplicating documentation of existing systems.

But yeah, will add an explanation to that. In a few words, Nix by default will not install any packages which are unfree so you need to set allowUnfree to true for Nix to install them.

[louwers]

Maybe document which editors/packages specifically require this setting -- many people (myself included) would rather not install non-free packages and want to keep allowUnfree false.

[freeman42x]

For the things I will work on myself I like to have a pragmatic approach.
Feel free to submit a PR if you want to get into this though