2021-02-15 00:41:15 +00:00
|
|
|
# Pull Requests
|
2021-06-03 19:25:06 +00:00
|
|
|
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
|
2021-02-15 00:41:15 +00:00
|
|
|
relevant docs. Each directory contains its own README.md, which will
|
2021-02-18 04:03:07 +00:00
|
|
|
automatically be pulled into the [mdbook](https://devos.divnix.com). The book is
|
2021-02-15 00:41:15 +00:00
|
|
|
rendered on every change, so the docs should always be up to date.
|
|
|
|
|
2021-03-14 07:10:51 +00:00
|
|
|
We also use [BORS](https://bors.tech) to ensure that all pull requests pass the
|
|
|
|
test suite once at least one review is completed.
|
2021-02-15 00:41:15 +00:00
|
|
|
|
|
|
|
## 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`][nixpkgs-fmt]. The default devshell
|
|
|
|
includes a pre-commit hook that does this for you.
|
|
|
|
|
|
|
|
* The commit message follows the same semantics as [nixpkgs][nixpkgs].
|
|
|
|
* You can use a `#` symbol to specify ambiguities. For example,
|
2021-04-22 23:10:02 +00:00
|
|
|
`develop#zsh: <rest of commit message>` would tell me that you're updating the
|
2021-02-15 00:41:15 +00:00
|
|
|
`zsh` subprofile living under the `develop` profile.
|
|
|
|
|
|
|
|
[nixpkgs-fmt]: https://github.com/nix-community/nixpkgs-fmt
|
|
|
|
[nixpkgs]: https://github.com/NixOS/nixpkgs
|