diff options
author | Naïm Favier <n@monade.li> | 2023-01-27 16:45:55 +0100 |
---|---|---|
committer | Naïm Favier <n@monade.li> | 2023-01-27 18:05:28 +0100 |
commit | 0288ee587fa2a977b7d7cc6c3b452a76f26b1cb7 (patch) | |
tree | 22517710aec7d2540118c9f3651f6808525801e1 | |
parent | 93dc2de29a92b3bcfb11b3f6a8c8ff8447ad162a (diff) |
maintainers: clarify what fields are required
-rw-r--r-- | lib/tests/maintainers.nix | 1 | ||||
-rw-r--r-- | maintainers/maintainer-list.nix | 8 |
2 files changed, 7 insertions, 2 deletions
diff --git a/lib/tests/maintainers.nix b/lib/tests/maintainers.nix index cb1e9ddd5288..be1c8aaa85c5 100644 --- a/lib/tests/maintainers.nix +++ b/lib/tests/maintainers.nix @@ -1,5 +1,6 @@ # to run these tests (and the others) # nix-build nixpkgs/lib/tests/release.nix +# These tests should stay in sync with the comment in maintainers/maintainers-list.nix { # The pkgs used for dependencies for the testing itself pkgs ? import ../.. {} , lib ? pkgs.lib diff --git a/maintainers/maintainer-list.nix b/maintainers/maintainer-list.nix index dd72cad382eb..09b3183e2f01 100644 --- a/maintainers/maintainer-list.nix +++ b/maintainers/maintainer-list.nix @@ -3,12 +3,13 @@ handle = { # Required name = "Your name"; - email = "address@example.org"; - # Optional + # Optional, but at least one of email, matrix or githubId must be given + email = "address@example.org"; matrix = "@user:example.org"; github = "GithubUsername"; githubId = your-github-id; + keys = [{ fingerprint = "AAAA BBBB CCCC DDDD EEEE FFFF 0000 1111 2222 3333"; }]; @@ -25,6 +26,9 @@ - `githubId` is your GitHub user ID, which can be found at `https://api.github.com/users/<userhandle>`, - `keys` is a list of your PGP/GPG key fingerprints. + Specifying a GitHub account ensures that you automatically get a review request on + pull requests that modify a package for which you are a maintainer. + `handle == github` is strongly preferred whenever `github` is an acceptable attribute name and is short and convenient. If `github` begins with a numeral, `handle` should be prefixed with an underscore. |