Skip to content

Commit ed5f9fd

Browse files
committed
Modify governance doc to replace PMC with Steering Committee
Signed-off-by: deepthi <[email protected]>
1 parent 74a7423 commit ed5f9fd

File tree

1 file changed

+17
-20
lines changed

1 file changed

+17
-20
lines changed

GOVERNANCE.md

+17-20
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Overview
44

5-
Vitess is a meritocratic, consensus-based community project. Anyone with an interest in the project can join the community, contribute to the project design and participate in the decision making process. This document describes how that participation takes place and how to set about earning merit within the project community.
5+
Vitess is an open community project. Anyone with an interest in the project can join the community, contribute to the project design and participate in the decision-making process. This document describes how that participation takes place and how to set about contributing within the project community.
66

77
# Roles And Responsibilities
88

@@ -12,10 +12,11 @@ Users are community members who have a need for the project. They are the most i
1212

1313
The project asks its users to participate in the project and community as much as possible. User contributions enable the project team to ensure that they are satisfying the needs of those users. Common user contributions include (but are not limited to):
1414

15-
* evangelising about the project (e.g. a link on a website and word-of-mouth awareness raising)
15+
* evangelizing about the project (e.g. a link on a website and word-of-mouth awareness raising)
1616
* informing developers of strengths and weaknesses from a new user perspective
1717
* providing moral support (a ‘thank you’ goes a long way)
1818
* providing financial support (the software is open source, but its developers need to eat)
19+
* adding their company logo to the project website
1920

2021
Users who continue to engage with the project and its community will often become more and more involved. Such users may find themselves becoming contributors, as described in the next section.
2122

@@ -31,56 +32,52 @@ In addition to their actions as users, contributors may also find themselves doi
3132
* reporting bugs
3233
* identifying requirements
3334
* providing graphics and web design
34-
* programming
3535
* assisting with project infrastructure
3636
* writing documentation
3737
* fixing bugs
3838
* adding features
39+
* speaking about the project in public forums
3940

40-
Contributors engage with the project through the issue tracker, mailing list, the Slack channel, or by writing or editing documentation. They submit changes to the project itself via pull requests, which will be considered for inclusion in the project by existing maintainers (see next section). The Slack channel is the most appropriate place to ask for help when making that first contribution.
41+
Contributors engage with the project through the issue tracker, mailing list, the Slack workspace, or by writing or editing documentation. They submit changes to the project itself via pull requests, which will be considered for inclusion in the project by existing maintainers (see next section).
4142

42-
As contributors gain experience and familiarity with the project, their profile within, and commitment to, the community will increase. At some stage, they may find themselves being nominated for maintainership.
43+
As contributors gain experience and familiarity with the project, their profile within, and commitment to, the community will increase. At some stage, they may find themselves being nominated for maintainer-ship.
4344

4445
## Maintainers
4546

46-
Maintainers are community members who have shown that they are committed to the continued development of the project through ongoing engagement with the community. Maintainership allows contributors to more easily carry on with their project related activities by giving them direct access to the project’s resources. That is, they can make changes directly to project outputs, without having to submit changes via pull requests.
47+
[Maintainers](https://github.com/vitessio/vitess/blob/main/MAINTAINERS.md) are community members who have shown that they are committed to the continued development of the project through ongoing engagement with the community. Maintainer-ship allows contributors to more easily carry on with their project related activities by giving them direct access to the project’s resources. That is, they can make changes directly to project outputs, without having to submit changes via pull requests.
4748

48-
This does not mean that a maintainer is free to do what they want. In fact, maintainers have no more authority over the project than contributors. While maintainership indicates a valued member of the community who has demonstrated a healthy respect for the project’s aims and objectives, their work continues to be reviewed by the community before acceptance in an official release.
49+
This does not mean that a maintainer is free to do what they want. In fact, maintainers have no more authority over the project than contributors. While maintainer-ship indicates a valued member of the community who has demonstrated a healthy respect for the project’s aims and objectives, their work continues to be reviewed by the community before acceptance in an official release.
4950

50-
A maintainer is not allowed to merge their change without approval from another person. However, they are allowed to sidestep this rule under justifiable circumstances. For example:
51+
A maintainer is not allowed to merge their change without approval from another person. However, a small number of maintainers are allowed to sidestep this rule under justifiable circumstances. For example:
5152

5253
* If a CI tool is broken, they may override the tool to still submit the change.
5354
* Minor typos or fixes for broken tests.
5455
* The change was approved through other means than the standard process.
5556

5657
Anyone can become a maintainer; there are no special requirements, other than to have shown a willingness and ability to participate in the project as a team player. Typically, a potential maintainer will need to show that they have an understanding of the project, its objectives and its strategy. They will also have provided valuable contributions to the project over a period of time.
5758

58-
New maintainers can be nominated by any existing maintainer. Once they have been nominated, there will be a vote by the project management committee (PMC; see below). Maintainer voting is one of the few activities that takes place on the project’s private management list. This is to allow PMC members to freely express their opinions about a nominee without causing embarrassment. Once the vote has been held, the aggregated voting results are published on the public mailing list. The nominee is entitled to request an explanation of any ‘no’ votes against them, regardless of the outcome of the vote. This explanation will be provided by the PMC Chair (see below) and will be anonymous and constructive in nature.
59+
New maintainers can be nominated by any existing maintainer. Once they have been nominated, there will be a vote by the steering committee. Maintainer voting is one of the few activities that takes place on the project’s private management list. This is to allow committee members to freely express their opinions about a nominee without causing embarrassment. Once the vote has been held, the aggregated voting results are published on the public mailing list. The nominee is entitled to request an explanation of any ‘no’ votes against them, regardless of the outcome of the vote. This explanation will be provided by the Steering Committee Chair (see below) and will be anonymous and constructive in nature.
5960

6061
Nominees may decline their appointment as a maintainer. However, this is unusual, as the project does not expect any specific time or resource commitment from its community members. The intention behind the role of maintainer is to allow people to contribute to the project more easily, not to tie them in to the project in any formal way.
6162

62-
It is important to recognise that maintainership is a privilege, not a right. That privilege must be earned and once earned it can be removed by the PMC for conduct inconsistent with the [Guiding Principles](https://github.com/vitessio/vitess/blob/main/GUIDING_PRINCIPLES.md) or if they drop below a level of commitment and engagement required to be a maintainer, as determined by the PMC. The PMC also reserves the right to remove a person for any other reason inconsistent with the goals of Vitess.
63+
It is important to recognise that maintainer-ship is a privilege, not a right. That privilege must be earned and once earned it can be removed by the Steering Committee for conduct inconsistent with the [Guiding Principles](https://github.com/vitessio/vitess/blob/main/GUIDING_PRINCIPLES.md) or if they drop below a level of commitment and engagement required to be a maintainer, as determined by the Steering Committee. The Steering Committee also reserves the right to remove a person for any other reason inconsistent with the goals of the project.
6364

64-
A maintainer who shows an above-average level of contribution to the project, particularly with respect to its strategic direction and long-term health, may be nominated to become a member of the PMC. This role is described below.
65-
66-
## Project management committee
67-
68-
The Project Management Committee has been dissolved. The project will move to a steering committee model of governance. In the interim, the maintainer team will fulfill the responsibilities that were formerly assigned to the PMC.
65+
A maintainer who shows an above-average level of contribution to the project, particularly with respect to its strategic direction and long-term health, may be nominated to become a member of the Steering Committee. This role is described in the [Steering Committee document](https://github.com/vitessio/vitess/blob/main/STEERING.md).
6966

7067
# Support
7168

72-
All participants in the community are encouraged to provide support for new users within the project management infrastructure. This support is provided as a way of growing the community. Those seeking support should recognise that all support activity within the project is voluntary and is therefore provided as and when time allows. A user requiring guaranteed response times or results should therefore seek to purchase a support contract from a community member. However, for those willing to engage with the project on its own terms, and willing to help support other users, the community support channels are ideal.
69+
All participants in the community are encouraged to provide support for new users. This support is provided as a way of growing the community. Those seeking support should recognise that all support activity within the project is voluntary and is therefore provided as and when time allows. A user requiring guaranteed response times or results should therefore seek to purchase a support contract from a community member. However, for those willing to engage with the project on its own terms, and willing to help support other users, the community support channels are ideal.
7370

7471
# Contribution Process
75-
Anyone can contribute to the project, regardless of their skills, as there are many ways to contribute. For instance, a contributor might be active on the Slack channel and issue tracker, or might create pull requests. The various ways of contributing are described in more detail in a separate document.
72+
Anyone can contribute to the project, regardless of their skills, as there are many ways to contribute. For instance, a contributor might be active on the Slack channel and issue tracker, or might create pull requests. The various ways of contributing are described in more detail in [a separate document](https://github.com/vitessio/vitess/blob/main/CONTRIBUTING.md).
7673

77-
The Slack channel list is the most appropriate place for a contributor to ask for help when making their first contribution.
74+
The Slack workspace is the most appropriate place for a contributor to ask for help when making their first contribution.
7875

7976
# Decision Making Process
8077

81-
Decisions about the future of the project are made by the PMC. New proposals and ideas can be brought to the PMC’s attention through the Slack channel or by filing an issue. If necessary, the PMC will seek input from others to come to the final decision.
78+
Decisions about the future of the project are made by the Steering Committee. New proposals and ideas can be brought to the Committee’s attention through the Slack workspace or by filing an issue. If necessary, the Committee will seek input from others to come to the final decision.
8279

83-
The PMC’s decision is itself governed by the project’s [Guiding Principles](https://github.com/vitessio/vitess/blob/main/GUIDING_PRINCIPLES.md), which shall be used to reach consensus. If a consensus cannot be reached, a simple majority voting process will be used to reach resolution. In case of a tie, the PMC chair has the casting vote.
80+
The Steering Committee's decisions will be governed by the project’s [Guiding Principles](https://github.com/vitessio/vitess/blob/main/GUIDING_PRINCIPLES.md), which shall be used to reach consensus. If a consensus cannot be reached, a simple majority voting process will be used to reach resolution. In case of a tie, the Committee chair has the deciding vote.
8481

8582
# Credits
8683
The contents of this document are based on http://oss-watch.ac.uk/resources/meritocraticgovernancemodel by Ross Gardler and Gabriel Hanganu.

0 commit comments

Comments
 (0)