mirror of
https://github.com/NixOS/nix.dev.git
synced 2024-10-18 14:32:43 -04:00
50 lines
2 KiB
Markdown
50 lines
2 KiB
Markdown
# Maintainer responsibilities
|
|
|
|
## Join the team meetings
|
|
|
|
Participate in the regular team meetings, see [meeting information and protocol](./README.md#team-meetings) for details.
|
|
|
|
If you can't participate, notify other team members.
|
|
|
|
## Stay informed
|
|
|
|
Follow relevant activities on these communication channels:
|
|
|
|
- GitHub
|
|
|
|
Subscribe to issues and pull requests you care about.
|
|
|
|
- Discourse
|
|
|
|
Set the notification level on the [Development > Documentation](https://discourse.nixos.org/c/dev/documentation/25) Discourse category to "watching".
|
|
|
|
- Matrix
|
|
|
|
Join the public [Nix\* Documentation](https://matrix.to/#/#docs:nixos.org) Matrix room and enable relevant notifications.
|
|
|
|
There is also a [private Matrix room](https://matrix.to/#/!DersLzqcNaaZvpnxKk:matrix.org) for exceptional, internal issues.
|
|
|
|
## Take ownership
|
|
|
|
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.
|
|
|
|
[`CODEOWNERS`]: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
|
|
|
|
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.
|
|
Make sure to follow up on bugs and regressions in the code you maintain.
|
|
|
|
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.
|
|
|
|
Make sure to reserve time for reviewing pull requests that fall within your area of interest or expertise.
|
|
|
|
## Provide guidance
|
|
|
|
Guide new and potential contributors:
|
|
|
|
- Help answering questions on the [Discourse Help category](https://discourse.nixos.org/c/learn/9)
|
|
- 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
|