This document is mainly intended for people who want to contribute to nixie. As a short reminder, this is generally what you would need to do:
- Fork and clone the repository
- Either stay on the
mainbranch, or create a new branch for your feature[feat|fix|...]/<name>. If you are working on multiple PRs at the same time, you should create new branches. - Run
nix develop. You will be put into a shell with a pre-commit-hook that automatically checks and lints your changes before you push. - Read the chapter below and implement your changes
- Once finished, create a commit, push your changes and submit a PR.
If you want to submit a change, please make sure you have checked the following things:
-
All checks must pass. You can run them with
nix flake check, which will also check formatting. -
This repository follows the Conventional Commits style. So each commit in your PR should contain only one logical change and the commit message should reflect that accordingly.
Example: If your PR changes two builders, you should also have two commits:
feat(builders/mkMinecraftServer): fix longstanding issuefeat(helpers/fetchSteam): speed up
Changes to builders should be scoped like
feat(builders/<builder_name>), same forhelpers/<helper_name>andmodules/<module_name>. If a change doesn't fit any of these scopes, then just don't add a scope.