Pull Requests

All development is done in the develop branch. Only minor bug-fixes and release PRs should target master.

If making a change to the template, or adding a feature, please be sure to update the relevant docs. Each directory contains its own README.md, which will automatically be pulled into the mdbook. The book is rendered on every change, so the docs should always be up to date.

We also use BORS to ensure that all pull requests pass the test suite once at least one review is completed.

Community PRs

While much of your work in this template may be idiosyncratic in nature. Anything that might be generally useful to the broader NixOS community can be synced to the community branch to provide a host of useful NixOS configurations available "out of the box".

Style

If you wish to contribute please follow these guidelines:

  • format your code with nixpkgs-fmt. The default devshell includes a pre-commit hook that does this for you.

  • The commit message follows the same semantics as nixpkgs.

    • You can use a # symbol to specify ambiguities. For example, develop#zsh: <rest of commit message> would tell me that you're updating the zsh subprofile living under the develop profile.