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:
parent
fde2d6a808
commit
1d8975b3c7
1 changed files with 47 additions and 38 deletions
|
@ -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.
|
|
||||||
|
|
Loading…
Add table
Reference in a new issue