2017-12-27 03:47:21 +03:00
|
|
|
# Project governance
|
|
|
|
|
|
|
|
The tldr-pages project strives to have an **open**, **welcoming**,
|
|
|
|
and [**non-hierarchical**](https://en.wikipedia.org/wiki/Flat_organization)
|
|
|
|
governance structure.
|
|
|
|
|
|
|
|
To that end, this document describes the principles
|
|
|
|
that guide the self-management of the project.
|
|
|
|
By having them written down explicitly, and open to scrutiny,
|
|
|
|
the entire community can read, improve and adapt them as needed,
|
|
|
|
with no central authority.
|
|
|
|
|
|
|
|
|
|
|
|
## I. Participation and community interactions
|
|
|
|
|
|
|
|
- **All contributions are welcome**,
|
|
|
|
[no matter how small](https://github.com/kentcdodds/all-contributors).
|
2018-01-09 13:23:56 +03:00
|
|
|
The tldr-pages project is a
|
|
|
|
[do-ocracy](https://communitywiki.org/wiki/DoOcracy),
|
|
|
|
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)
|
2017-12-27 03:47:21 +03:00
|
|
|
to get started.
|
|
|
|
|
2018-01-09 13:23:56 +03:00
|
|
|
- All members of the community are expected to
|
|
|
|
**be cordial in all communications**.
|
|
|
|
Avoid making assumptions about the others' intentions,
|
|
|
|
and make your own intentions clear.
|
2017-12-27 03:47:21 +03:00
|
|
|
When in doubt, provide additional context, or ask for clarification.
|
|
|
|
Remember, it's very hard to convey meaning on a purely written medium,
|
|
|
|
especially between people from different cultures, technical backgrounds,
|
|
|
|
English proficiency levels, etc.
|
|
|
|
|
|
|
|
- **All communications are public**.
|
2018-01-09 13:23:56 +03:00
|
|
|
There are no permanent private channels
|
|
|
|
where maintainers discuss "internal" matters.
|
2017-12-27 15:58:13 +03:00
|
|
|
Occasional private chat or email messages may be exchanged,
|
2017-12-27 03:47:21 +03:00
|
|
|
e.g. when setting up services that require passwords,
|
2017-12-27 15:58:13 +03:00
|
|
|
but otherwise all communications that impact the project
|
|
|
|
will either happen in issue and PR discussions,
|
2017-12-27 03:47:21 +03:00
|
|
|
or in the [Gitter chat room](https://gitter.im/tldr-pages/tldr)
|
|
|
|
(which is open to all, and publicly logged).
|
|
|
|
|
|
|
|
- **All decisions are made by community consensus.**
|
|
|
|
This does not mean there has to be unanimity,
|
|
|
|
nor that decisions result from vote counts.
|
2018-01-09 13:23:56 +03:00
|
|
|
What it means is that
|
|
|
|
every interested member of the community can voice their thoughts,
|
2017-12-27 03:47:21 +03:00
|
|
|
and different positions are ideally resolved via
|
|
|
|
[informed consent](https://en.wikipedia.org/wiki/Sociocracy#Consent_vs._consensus)
|
|
|
|
of the involved people, who accept the collective decision
|
|
|
|
as "good enough for now, safe enough to try".
|
|
|
|
|
|
|
|
|
|
|
|
## II. Role transitions
|
|
|
|
|
2018-01-09 13:23:56 +03:00
|
|
|
The main goal of these principles
|
|
|
|
is to support a continuous replenishing of the management team
|
2017-12-27 03:47:21 +03:00
|
|
|
via a **smooth transition flow between community roles** —
|
|
|
|
from newcomer, to occasional contributor, to regular contributor, to maintainer.
|
|
|
|
This way the project can adapt in a flexible way
|
|
|
|
to the the natural variations in availability and interest of its contributors,
|
2018-01-09 13:23:56 +03:00
|
|
|
ensuring long-term resilience, and avoiding
|
|
|
|
[single points of failure](https://en.wikipedia.org/wiki/Bus_factor).
|
2017-12-27 03:47:21 +03:00
|
|
|
|
|
|
|
To this end, rather than assigning roles and tasks to people,
|
|
|
|
these guidelines instead aim to **recognize the work that people already do**.
|
2018-01-09 13:23:56 +03:00
|
|
|
Everyone is therefore encouraged to get involved
|
|
|
|
and contribute to the project in whatever way they prefer,
|
2017-12-27 03:47:21 +03:00
|
|
|
and we will strive to **get barriers out of the way** of these contributions.
|
|
|
|
|
2018-01-09 13:23:56 +03:00
|
|
|
To ensure that these processes are
|
|
|
|
transparent, predictable, and free from subective judgment,
|
2017-12-27 03:47:21 +03:00
|
|
|
the metrics used are simple, objective, and publicly available.
|
|
|
|
|
|
|
|
- Regular contributors shall be recognized as collaborators in the organization.
|
|
|
|
|
|
|
|
- Specifically: once a contributor has had **5 pull requests merged**,
|
|
|
|
they should be invited to become a
|
|
|
|
[**member of the tldr-pages organization**](https://github.com/orgs/tldr-pages/people).
|
2018-01-09 13:23:56 +03:00
|
|
|
This means they will be able to
|
|
|
|
push commits to all of the organization's repositories,
|
2017-12-27 03:47:21 +03:00
|
|
|
merge PRs, label and close issues, among other things.
|
2018-01-09 13:23:56 +03:00
|
|
|
Note: All members of the tldr-pages organization
|
|
|
|
must make their membership public.
|
|
|
|
|
|
|
|
- Members of the organization
|
|
|
|
who demonstrate interest in performing maintainership tasks,
|
|
|
|
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
|
2017-12-27 03:47:21 +03:00
|
|
|
in the [MAINTAINERS.md](MAINTAINERS.md) file.
|
|
|
|
|
2018-01-09 13:23:56 +03:00
|
|
|
- Specifically: once a contributor has been an organization member
|
|
|
|
for at least 3 months,
|
2017-12-27 03:47:21 +03:00
|
|
|
and has **reviewed or merged 10 pull requests** by other contributors,
|
2018-01-09 13:23:56 +03:00
|
|
|
they should be invited to become
|
|
|
|
an **owner of the tldr-pages organization**.
|
2017-12-27 03:47:21 +03:00
|
|
|
This means they will be able to add people to the organization,
|
|
|
|
manage all the organization's repositories, configure integrations, etc.
|
|
|
|
|
2018-01-09 13:23:56 +03:00
|
|
|
- If a collaborator or maintainer stops being active in the project
|
|
|
|
for more than 6 months,
|
|
|
|
their membership status will be equally deactivated
|
|
|
|
and their name added to the list of former maintainers
|
|
|
|
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,
|
2017-12-27 15:58:13 +03:00
|
|
|
they should be added back to the organization, to reflect that fact.
|
2017-12-27 03:47:21 +03:00
|
|
|
|
|
|
|
- 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.
|