nix.dev/maintainers/responsibilities.md
2024-02-05 12:42:53 +00:00

2.0 KiB

Maintainer responsibilities

Join the team meetings

Participate in the regular team meetings, see meeting information and protocol 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 Discourse category to "watching".

  • Matrix

    Join the public Nix* Documentation Matrix room and enable relevant notifications.

    There is also a private Matrix room 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.

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
  • 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