1
0
Fork 0
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:
Waldir Pimenta 2018-01-09 10:23:56 +00:00
parent 652590372d
commit 33fc4653c9

View file

@ -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