2022-12-01 12:52:01 -05:00
# Maintainer responsibilities
2022-12-01 17:34:40 -05:00
## Join the team meetings
2022-12-01 12:52:01 -05:00
2024-02-05 07:42:53 -05:00
Participate in the regular team meetings, see [meeting information and protocol ](./README.md#team-meetings ) for details.
2022-12-01 17:34:40 -05:00
If you can't participate, notify other team members.
## Stay informed
Follow relevant activities on these communication channels:
2022-12-01 12:52:01 -05:00
- GitHub
2022-12-01 17:34:40 -05:00
Subscribe to issues and pull requests you care about.
2022-12-01 12:52:01 -05:00
- Discourse
2022-12-01 17:34:40 -05:00
2024-02-05 07:42:53 -05:00
Set the notification level on the [Development > Documentation ](https://discourse.nixos.org/c/dev/documentation/25 ) Discourse category to "watching".
2022-12-01 17:34:40 -05:00
2022-12-01 12:52:01 -05:00
- Matrix
2024-02-05 07:42:53 -05:00
Join the public [Nix\* Documentation ](https://matrix.to/#/#docs:nixos.org ) Matrix room and enable relevant notifications.
2022-12-01 12:52:01 -05:00
2024-02-05 07:42:53 -05:00
There is also a [private Matrix room ](https://matrix.to/#/!DersLzqcNaaZvpnxKk:matrix.org ) for exceptional, internal issues.
2022-12-01 12:52:01 -05:00
2022-12-01 17:34:40 -05:00
## Take ownership
2022-12-01 12:52:01 -05:00
2023-06-22 06:00:23 -04:00
The team has entries in the [`CODEOWNERS`] file in the respective repositories.
GitHub will request reviews for pull requests that change files the team owns.
2022-12-01 12:52:01 -05:00
2022-12-01 17:34:40 -05:00
[`CODEOWNERS`]: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
2022-12-01 12:52:01 -05:00
2023-06-22 06:00:23 -04:00
Team members can review and approve changes, which then have to merged by the team lead, since GitHub currently does not allow more granular permission management.
As a maintainer, you and the team lead are responsible for the changes you approve.
2022-12-01 17:34:40 -05:00
Make sure to follow up on bugs and regressions in the code you maintain.
2022-12-01 12:52:01 -05:00
2022-12-01 17:34:40 -05:00
Respond to `@` mentions on GitHub, Discourse, and Matrix within reasonable time.
Notify readers if you cannot deal with the issue due to time constraints or other priorities.
2022-12-01 12:52:01 -05:00
2022-12-01 17:34:40 -05:00
Make sure to reserve time for reviewing pull requests that fall within your area of interest or expertise.
2022-12-01 12:52:01 -05:00
2022-12-01 17:34:40 -05:00
## Provide guidance
2022-12-01 12:52:01 -05:00
2023-06-22 06:00:23 -04:00
Guide new and potential contributors:
2022-12-01 12:52:01 -05:00
2024-02-05 07:42:53 -05:00
- Help answering questions on the [Discourse Help category ](https://discourse.nixos.org/c/learn/9 )
2023-06-22 06:00:23 -04:00
- Encourage question authors to raise or upvote issues on GitHub, if needed
- Assist them with making pull requests to solve the underlying problems, if possible