talexander/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Releases Activity

maintainers/README.md: expand section on maintainer tooling

Browse Source 
Addresses https://github.com/NixOS/nixpkgs/issues/234293#issuecomment-3000177145
This commit is contained in:
Peder Bergebakken Sundt 2025-06-24 23:09:45 +02:00
parent 81b170f9b0
commit ab12c2ca96
1 changed files with 27 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
maintainers/README.md
View File

@ -58,10 +58,34 @@ person as a reviewer, and then waiting a week for a reaction.
The maintainer is welcome to come back at any time. The maintainer is welcome to come back at any time.
### Tools for maintainers ## Tools for maintainers
When a pull request is made against a package, OfBorg will notify the When a pull request is made against a package, nixpkgs CI will notify the appropriate
appropriate maintainer(s). maintainer(s) by trying to correlate the files the PR touches with the packages that need rebuilding.
Maintainers can also invoke the [nixpkgs-merge-bot](https://github.com/nixos/nixpkgs-merge-bot)
to merge pull requests targeting packages they are the maintainer of, which satisfy the current
security [constraints](https://github.com/NixOS/nixpkgs-merge-bot/blob/main/README.md#constraints).
Examples: [#397273](https://github.com/NixOS/nixpkgs/pull/397273#issuecomment-2789382120) and [#377027](https://github.com/NixOS/nixpkgs/pull/377027#issuecomment-2614510869)
New maintainers will automatically get invited to join the [NixOS/nixpkgs-maintainers](https://github.com/orgs/NixOS/teams/nixpkgs-maintainers) GitHub team.
By joining, you will get some triaging rights in the nixpkgs repository, like the ability to close and reopen issues made by others, and managing labels.
However, the GitHub team invite is usually only sent by email, and is only valid for one week!
Should it expire, please ask for a re-invite in the [GitHub org owners help desk Matrix channel](https://matrix.to/#/#org_owners:nixos.org).
### Unofficial maintainer tooling
[zh.fail](https://zh.fail/failed/overview.html) tracks all package build failures on `master` grouped by maintainer.
[asymmetric/nixpkgs-update-notifier](https://github.com/asymmetric/nixpkgs-update-notifier) is a matrix
bot that scrapes the [nixpkgs-update logs](https://nixpkgs-update-logs.nix-community.org/) and notifies
you if nixpkgs-update/@r-ryantm fails to update any of the packages you've subscribed to.
[repology.org](https://repology.org) tracks and compares the versions of packages between various package repositories, letting you know what packages may be out of date or insecure.
You can view which packages a specific maintainer maintains and subscribe to updates with atom/rss. Example: [repology.org/maintainer/pbsds](https://repology.org/maintainer/pbsds%40hotmail.com).
[nixpk.gs/pr-tracker](https://nixpk.gs/pr-tracker.html) and [nixpkgs-tracker.ocfox.me](https://nixpkgs-tracker.ocfox.me/)
can visualize the release status of any nixpkgs pull request.
## Reviewing contributions ## Reviewing contributions