mirror of
https://github.com/tldr-pages/tldr.git
synced 2025-04-29 23:24:55 +02:00
GOVERNANCE.md: wrap to 80 characters
This commit is contained in:
parent
652590372d
commit
33fc4653c9
1 changed files with 44 additions and 24 deletions
|
@ -15,20 +15,25 @@ with no central authority.
|
||||||
|
|
||||||
- **All contributions are welcome**,
|
- **All contributions are welcome**,
|
||||||
[no matter how small](https://github.com/kentcdodds/all-contributors).
|
[no matter how small](https://github.com/kentcdodds/all-contributors).
|
||||||
The tldr-pages project is a [do-ocracy](https://communitywiki.org/wiki/DoOcracy),
|
The tldr-pages project is a
|
||||||
so don't hesitate to get involved — we're happy to welcome you into the community!
|
[do-ocracy](https://communitywiki.org/wiki/DoOcracy),
|
||||||
Please take a look at [CONTRIBUTING.md](https://github.com/tldr-pages/tldr/blob/master/CONTRIBUTING.md)
|
so don't hesitate to get involved
|
||||||
|
— we're happy to welcome you into the community!
|
||||||
|
Please take a look at [CONTRIBUTING.md](CONTRIBUTING.md)
|
||||||
to get started.
|
to get started.
|
||||||
|
|
||||||
- All members of the community are expected to **be cordial in all communications**.
|
- All members of the community are expected to
|
||||||
Avoid making assumptions about the others' intentions, and make your own intentions clear.
|
**be cordial in all communications**.
|
||||||
|
Avoid making assumptions about the others' intentions,
|
||||||
|
and make your own intentions clear.
|
||||||
When in doubt, provide additional context, or ask for clarification.
|
When in doubt, provide additional context, or ask for clarification.
|
||||||
Remember, it's very hard to convey meaning on a purely written medium,
|
Remember, it's very hard to convey meaning on a purely written medium,
|
||||||
especially between people from different cultures, technical backgrounds,
|
especially between people from different cultures, technical backgrounds,
|
||||||
English proficiency levels, etc.
|
English proficiency levels, etc.
|
||||||
|
|
||||||
- **All communications are public**.
|
- **All communications are public**.
|
||||||
There are no permanent private channels where maintainers discuss "internal" matters.
|
There are no permanent private channels
|
||||||
|
where maintainers discuss "internal" matters.
|
||||||
Occasional private chat or email messages may be exchanged,
|
Occasional private chat or email messages may be exchanged,
|
||||||
e.g. when setting up services that require passwords,
|
e.g. when setting up services that require passwords,
|
||||||
but otherwise all communications that impact the project
|
but otherwise all communications that impact the project
|
||||||
|
@ -39,7 +44,8 @@ with no central authority.
|
||||||
- **All decisions are made by community consensus.**
|
- **All decisions are made by community consensus.**
|
||||||
This does not mean there has to be unanimity,
|
This does not mean there has to be unanimity,
|
||||||
nor that decisions result from vote counts.
|
nor that decisions result from vote counts.
|
||||||
What it means is that every interested member of the community can voice their thoughts,
|
What it means is that
|
||||||
|
every interested member of the community can voice their thoughts,
|
||||||
and different positions are ideally resolved via
|
and different positions are ideally resolved via
|
||||||
[informed consent](https://en.wikipedia.org/wiki/Sociocracy#Consent_vs._consensus)
|
[informed consent](https://en.wikipedia.org/wiki/Sociocracy#Consent_vs._consensus)
|
||||||
of the involved people, who accept the collective decision
|
of the involved people, who accept the collective decision
|
||||||
|
@ -48,20 +54,23 @@ with no central authority.
|
||||||
|
|
||||||
## II. Role transitions
|
## II. Role transitions
|
||||||
|
|
||||||
The main goal of these principles is to support a continuous replenishing of the management team
|
The main goal of these principles
|
||||||
|
is to support a continuous replenishing of the management team
|
||||||
via 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 can adapt in a flexible way
|
||||||
to the the natural variations in availability and interest of its contributors,
|
to the the natural variations in availability and interest of its contributors,
|
||||||
ensuring long-term resilience,
|
ensuring long-term resilience, and avoiding
|
||||||
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 instead aim to **recognize the work that people already do**.
|
||||||
Everyone is therefore encouraged to get involved and contribute to the project in whatever way they prefer,
|
Everyone is therefore encouraged to get involved
|
||||||
|
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.
|
||||||
|
|
||||||
To ensure that these processes are transparent, predictable, and free from subective judgment,
|
To ensure that these processes are
|
||||||
|
transparent, predictable, and free from subective judgment,
|
||||||
the metrics used are simple, objective, and publicly available.
|
the metrics used are simple, objective, and publicly available.
|
||||||
|
|
||||||
- Regular contributors shall be recognized as collaborators in the organization.
|
- Regular contributors shall be recognized as collaborators in the organization.
|
||||||
|
@ -69,26 +78,37 @@ the metrics used are simple, objective, and publicly available.
|
||||||
- Specifically: once a contributor has had **5 pull requests merged**,
|
- Specifically: once a contributor has had **5 pull requests merged**,
|
||||||
they should be invited to become a
|
they should be invited to become a
|
||||||
[**member of the tldr-pages organization**](https://github.com/orgs/tldr-pages/people).
|
[**member of the tldr-pages organization**](https://github.com/orgs/tldr-pages/people).
|
||||||
This means they will be able to push commits to all of the organization's repositories,
|
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.
|
merge PRs, label and close issues, among other things.
|
||||||
Note: All members of the tldr-pages organization must make their membership public.
|
Note: All members of the tldr-pages organization
|
||||||
|
must make their membership public.
|
||||||
|
|
||||||
- Members of the organization who demonstrate interest in performing maintainership tasks,
|
- Members of the organization
|
||||||
by reviewing and/or merging PRs, responding to and labeling issues, and generally doing project maintenance work,
|
who demonstrate interest in performing maintainership tasks,
|
||||||
shall be made part of the maintenance team, and their name added to the list of current maintainers
|
by reviewing and/or merging PRs, responding to and labeling issues,
|
||||||
|
and generally doing project maintenance work,
|
||||||
|
shall be made part of the maintenance team,
|
||||||
|
and their name 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 for at least 3 months,
|
- Specifically: once a contributor has been an organization member
|
||||||
|
for at least 3 months,
|
||||||
and has **reviewed or merged 10 pull requests** by other contributors,
|
and has **reviewed or merged 10 pull requests** by other contributors,
|
||||||
they should be invited to become an **owner of the tldr-pages organization**.
|
they should be invited to become
|
||||||
|
an **owner of the tldr-pages organization**.
|
||||||
This means they will be able to add people to the organization,
|
This means they will be able to add people to the organization,
|
||||||
manage all the organization's repositories, configure integrations, etc.
|
manage all the organization's repositories, configure integrations, etc.
|
||||||
|
|
||||||
- If a collaborator or maintainer stops being active in the project for more than 6 months,
|
- If a collaborator or maintainer stops being active in the project
|
||||||
their membership status will be equally deactivated,
|
for more than 6 months,
|
||||||
and their name added to the list of former maintainers in the MAINTAINERS.md file.
|
their membership status will be equally deactivated
|
||||||
Again, this is and merely a reflection of their actual involvement with the project,
|
and their name added to the list of former maintainers
|
||||||
not a demotion or punishment. In fact, if they return to active participation in the project,
|
in the MAINTAINERS.md file.
|
||||||
|
Again, this is and merely a reflection
|
||||||
|
of their actual involvement with the project,
|
||||||
|
not a demotion or punishment.
|
||||||
|
In fact, 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
|
- This inactivity threshold additionally ensures
|
||||||
|
|
Loading…
Add table
Reference in a new issue