about summary refs log tree commit diff
path: root/pkgs/README.md
diff options
context:
space:
mode:
authorDS <commits@sidhion.com>2023-10-23 19:51:50 -0700
committerDS <commits@sidhion.com>2023-11-13 20:41:08 -0800
commite93a3d7b586022f900f176cf46e7a3bf211cfaf9 (patch)
tree041f030beff32d18bc1bda52f0a60add1bf747d4 /pkgs/README.md
parent30c67fb5a635e0f53d03dd3825b0f11e8afd4b7d (diff)
doc: separate commit header conventions for each area, info on docs changes.
Diffstat (limited to 'pkgs/README.md')
-rw-r--r--pkgs/README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/pkgs/README.md b/pkgs/README.md
index 642833d968f37..fc33ecea199e6 100644
--- a/pkgs/README.md
+++ b/pkgs/README.md
@@ -114,6 +114,25 @@ Now that this is out of the way. To add a package to Nixpkgs:
 
 7. Optionally commit the new package and open a pull request [to nixpkgs](https://github.com/NixOS/nixpkgs/pulls), or use [the Patches category](https://discourse.nixos.org/t/about-the-patches-category/477) on Discourse for sending a patch without a GitHub account.
 
+## Commit conventions
+
+- Make sure you read about the [commit conventions](../CONTRIBUTING.md#commit-conventions) common to Nixpkgs as a whole.
+
+- Format the commit messages in the following way:
+
+  ```
+  (pkg-name): (from -> to | init at version | refactor | etc)
+
+  (Motivation for change. Link to release notes. Additional information.)
+  ```
+
+  Examples:
+
+  * nginx: init at 2.0.1
+  * firefox: 54.0.1 -> 55.0
+
+    https://www.mozilla.org/en-US/firefox/55.0/releasenotes/
+
 ## Category Hierarchy
 [categories]: #category-hierarchy