Skip to content

Latest commit

 

History

History
78 lines (53 loc) · 4.58 KB

MAINTAINERS.md

File metadata and controls

78 lines (53 loc) · 4.58 KB

What do maintainers do?

Maintainers are people who take an active role in writing code that advances the Baseline Protocol and/or related projects (e.g. reference implementations such as BRI-3). They are primarily responsible for:

  • Contributing code to the project in the form of PRs that are linked to open and prioritized issues
  • Reviewing and merging PRs into the master branch
  • Cutting, testing, and releasing new versions of the related Baseline projects
  • Working with the TSC advance the Baseline Protocol

They can/should also contribute in the following ways:

  • Writing epics and issues to guide development
  • Setting up and supporting infrastructure (running demos, CI systems, community projects, etc...) that further Baseline
  • Working with the community to help with adoption
  • Presenting the project and key technologies to the public (in-person, webinar, videos, articles, etc...)

Who are the current maintainers?

Code and Systems maintainers

How to become a maintainer?

There are two ways to become a maintainer: You are asked by a current maintainer, or you make a request to an existing maintainer to become one.

With either path you become a "provisional maintainer". As such you will need to show consistent contributions of code to the project. This can be in the form of pull requests that get merged into master. Or it can be in the form of system architecture and related artifacts that guide the development activities of others.

All provisional maintainers must meet with the existing maintainers and demonstrate they are capable of the following:

  • Running the project locally
  • Using the testing framework
  • Explaining the components of the system architecture
  • Walking through the code and explain the baseline process

Once the provisional maintainer demonstrates their capabilities, the existing maintainers will vote during the next scheduled maintainer meeting to give the prospect full maintainer status. Members must vote with 2/3rds majority to add a new maintainer. Voting that results in a tie or potentially other issue will be brought to the TSC for review.

What is expected of maintainers?

In general, a maintainer needs to:

  • be an expert in one or more fields related to the project
  • show commitment over time with multiple PRs merged
  • be reliable in completing issues to which they have been assigned
  • attend the weekly maintainer meetings (with occasional absences allowed)
  • demonstrate competency in software development
  • follow the project style and testing guidelines
  • have a high degree of understanding of the project architecture
  • be welcoming to others in the community who are using the project
  • contribute in ways that substantially improve the quality of the project and the experience of people who use it
  • follow branch, PR, and code style conventions

How maintainers organize?

Slack

Maintainers meet and discuss issues virtually via the private #maintainers slack room in the baseline slack.

Bi-Weekly Meetings

There are Bi-Weekly Maintainers meetings(https://us06web.zoom.us/j/88974739050?pwd=M2w1THFHdzBkaXp0STZtWXQyZXlYQT09) where members can discuss plans and issues related to the project, updates, release planning, and other related topics. These meetings are not public but special exceptions can be granted for members of the baseline community, experts, or other key participants. The summaries of the meetings will be posted to the public #maintainer-meeting slack room.

How to stop being a maintainer?

Any of the following ways:

  • You stop reviewing PR's, responding to messages, answering emails, and/or generally ghost the project.
  • You are disrespectful towards anyone in the community and/or involved in the project.
  • You are disruptive to the general process of maintaining the project, meetings, discussions, issues, or other.
  • You violate the code of conduct.
  • You notify the other maintainers you would like to relinquish your maintainer status.

Two-thirds of all current maintainers constitute a quorum for a meeting involving a question of removal. A simple majority vote from maintainers attending the meeting is required to remove a maintainer, but the TSC may be brought in to arbitrate if the maintainer to be removed or any other maintainer wishes to dispute the action.