Remove legacy documentation about commit message conventions predating the standardized format introduced in commitbf31640f49("doc: specify commit message format") on 2024-01-23, with the final GitMoji usage in commit5a7f3f15cc("Add guide for creating modules 📝").
1.3 KiB
1.3 KiB
Commit Convention
To keep things consistent, commit messages should follow a format similar to Nixpkgs:
«scope»: «summary»
«motivation for change»
Where the scope is one of:
| Scope | Purpose |
|---|---|
ci |
Changes to GitHub Actions workflows. |
doc |
Changes to the website, README.md, and so on. |
stylix |
Changes in the stylix directory, flake.nix, and other global code. |
| Name of target | Changes to code for a particular target. |
treewide |
Changes across many targets. |
The scope is meant to indicate which area of the code was changed. Specifying
the type of change, such as feat or fix, is not necessary. Dependency
updates should use whichever scope they are related to.
The summary should start with a lowercase letter, and should not end with punctuation.
Most commits to master will also include a pull request number in brackets
after the summary. GitHub adds this automatically when creating a squash merge.