4.6 KiB

Raw Blame History

Community roles

The following guidelines aim to keep the project vibrant and responsive, by ensuring a smooth transition flow between community roles — from newcomer, to occasional contributor, to regular contributor, to maintainer. This way, the project should be able to adapt dynamically and flexibly to the natural variations in availability and interest of its contributors, improving long-term resilience, reducing the risk of burnout, and avoiding single points of failure.

To this end, rather than assigning roles and tasks to people, these guidelines 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, and we will strive to get barriers out of the way of these contributions.

To ensure that these role transitioning processes are straightforward, transparent, predictable, and impartial, the metrics used are objective, easy to check, and explicitly described below. (That's not to say they're hard-set rules: exceptions can always be considered, via open community discussion.)

When to change roles

Regular contributors should be added as collaborators in the repository. Specifically: once a contributor has had 5 non-trivial 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.
Collaborators who perform maintenance tasks should be made org members. (Maintenance work is understood as facilitating contributions by other people, which in this project consists primarily of reviewing and/or merging PRs.) Specifically: once a repository collaborator has merged at least 10 PRs and submitted at least 5 non-trivial reviews to PRs (either the same or different ones) they should be invited to become a member 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.
Maintainers who have been helping out for a while should become org owners. Specifically: members of the tldr-pages organization who remain active for at least 6 months should be invited to become an owner 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.
These roles are temporary, and that's OK. People's interests and availability naturally change over time, so the project should regularly update the list of people in each role, in order to accurately reflect the active team managing the project (and to avoid conveying an undue sense of obligation on people whose priorities have shifted.) Specifically: If an organization member becomes inactive for over 6 months, their membership status should be equally deactivated. (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 of their actual involvement with the project, not a demotion or punishment. Indeed, if they return to active participation in the project, they should be added back to the organization, to reflect that fact.

Who can change roles

Current owners

The following people are the current owners of the tldr-pages organization, have admin access to all of its repositories, and are responsible for performing role changes in the community.

Romain Prieto <romain.prieto@gmail.com> (@rprieto)
Igor Shubovych <igor.shubovych@gmail.com> (@igorshubovych)
Ruben Vereecken <rubenvereecken@gmail.com> (@rubenvereecken)
Waldir Pimenta <waldyrious@gmail.com> (@waldyrious)
Felix Yan <felixonmars@archlinux.org> (@felixonmars)
Leandro Ostera <leandro@ostera.io> (@ostera)
Agniva De Sarker <agnivade@yahoo.co.in> (@agnivade)
Starbeamrainbowlabs <feedback@starbeamrainbowlabs.com> (@sbrl)

Past owners

The following people used to be owners in the tldr-pages organization, and have since moved on to other projects. Their contributions and dedication have ensured the success of the tldr project, and for that they'll always be appreciated.