1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-04-29 23:24:55 +02:00

GOVERNANCE.md: rework role transitions section to define 3 stages

This commit is contained in:
Waldir Pimenta 2018-01-09 14:21:34 +00:00
parent fde2d6a808
commit 1d8975b3c7

View file

@ -53,17 +53,16 @@ with no central authority.
## II. Role transitions ## II. Role transitions
The main goal of these principles The following guidelines aim to keep the project vibrant and responsive,
is to encourage a continuous replenishing of the management team by ensuring a **smooth transition flow between community roles**
via a **smooth transition flow between community roles**
from newcomer, to occasional contributor, to regular contributor, to maintainer. from newcomer, to occasional contributor, to regular contributor, to maintainer.
This way the project can adapt in a flexible way This way, the project should be able to adapt dynamically and flexibly
to the the natural variations in availability and interest of its contributors, to the natural variations in availability and interest of its contributors,
ensuring long-term resilience, and avoiding improving long-term resilience, reducing the risk of burnout, and avoiding
[single points of failure](https://en.wikipedia.org/wiki/Bus_factor). [single points of failure](https://en.wikipedia.org/wiki/Bus_factor).
To this end, rather than assigning roles and tasks to people, To this end, rather than _assigning_ roles and tasks to people,
these guidelines instead aim to **recognize the work that people already do**. these guidelines aim to **recognize the work that people already do**.
Everyone is therefore encouraged to get involved Everyone is therefore encouraged to get involved
and contribute to the project in whatever way they prefer, and contribute to the project in whatever way they prefer,
and we will strive to **get barriers out of the way** of these contributions. and we will strive to **get barriers out of the way** of these contributions.
@ -74,44 +73,54 @@ the metrics used are objective, easy to check, and explicitly described below.
(That's not to say they're hard-set rules: (That's not to say they're hard-set rules:
exceptions can always be considered, via open community discussion.) exceptions can always be considered, via open community discussion.)
- Regular contributors shall be recognized as collaborators in the organization. - **Regular contributors should be added as collaborators in the repository.**
Specifically: once a contributor has had _5 pull requests merged_
on a repository under the tldr-pages organization,
they should be invited to become
a **collaborator** in that repository.
This means they will be able to push commits to that repository,
as well as merge PRs, label and close issues, among other things.
- Specifically: once a contributor has had **5 pull requests merged**, - **Collaborators who perform maintenance tasks should be made org members.**
they should be invited to become a (Maintenance work is understood as facilitating contributions by other people,
[**member of the tldr-pages organization**](https://github.com/orgs/tldr-pages/people). which in this project consists primarily of reviewing and/or merging PRs.)
This means they will be able to Specifically: once a repository collaborator has _merged at least 10 PRs_
push commits to all of the organization's repositories, and submitted at least _5 non-trivial reviews to PRs_
merge PRs, label and close issues, among other things. (either the same or different ones)
Note: All members of the tldr-pages organization they should be invited to become a
must make their membership public. [**member**](https://github.com/orgs/tldr-pages/people)
of the tldr-pages organization.
This means they will be able to
push commits to all of the organization's repositories,
merge PRs, label and close issues, among other things.
_Note_: All members of the tldr-pages organization
must make their membership public.
- Members of the organization - **Maintainers who have been helping out for a while should become org owners.**
who demonstrate interest in performing maintainership tasks, Specifically: members of the tldr-pages organization
by reviewing and/or merging PRs, responding to and labeling issues, who remain _active for at least 6 months_
and generally doing project maintenance work, should be invited to become an
shall be made part of the maintenance team, [**owner**](https://help.github.com/articles/permission-levels-for-an-organization/).
and their name added to the list of current maintainers of the tldr-pages organization.
This means they will be able to add people to the organization,
manage all the organization's repositories, configure integrations, etc.
They should also be added to the list of current maintainers
in the [MAINTAINERS.md](MAINTAINERS.md) file. in the [MAINTAINERS.md](MAINTAINERS.md) file.
- Specifically: once a contributor has been an organization member - **These roles are temporary, and that's OK.**
for at least 3 months, People's interests and availability naturally change over time,
and has **reviewed or merged 10 pull requests** by other contributors, so the project should regularly update the list of people in each role,
they should be invited to become in order to accurately reflect the active team managing the project
an **owner of the tldr-pages organization**. (and to avoid conveying an undue sense of obligation
This means they will be able to add people to the organization, on people whose priorities have shifted.)
manage all the organization's repositories, configure integrations, etc. Specifically: If an organization member becomes _inactive for over 6 months_,
their membership status should be equally deactivated
- If a collaborator or maintainer stops being active in the project
for more than 6 months,
their membership status should be equally ceased
and their name added to the list of former maintainers and their name added to the list of former maintainers
in the MAINTAINERS.md file. in the MAINTAINERS.md file.
(They should nevertheless remain as collaborators
in the repositories on which they have been active in the past.)
Again, this is and merely a reflection Again, this is and merely a reflection
of their actual involvement with the project, of their actual involvement with the project,
not a demotion or punishment. not a demotion or punishment.
Indeed, if they return to active participation in the project, Indeed, if they return to active participation in the project,
they should be added back to the organization, to reflect that fact. they should be added back to the organization, to reflect that fact.
- This inactivity threshold additionally ensures
that the list of organization members doesn't grow to unwieldy sizes,
and that it accurately reflects the active team managing the project.