|
| 1 | +--- |
| 2 | +title: Contributor Ladder |
| 3 | +toc_hide: true |
| 4 | +status: Completed |
| 5 | +menu: |
| 6 | + main: |
| 7 | + weight: 10 |
| 8 | +--- |
| 9 | + |
| 10 | +Hi there! 👋 Thanks for your interest in contributing to the TODO Glossary project. |
| 11 | +Whether you contribute new terms, help localize the Glossary into your native language, |
| 12 | +or want to help others get started, there are many ways to become an active member of this community. |
| 13 | +This doc outlines the different contributor roles within the project and the responsibilities and privileges that come with them. |
| 14 | + |
| 15 | +## 1. Contributors |
| 16 | + |
| 17 | +The Glossary is for everyone. Anyone can become a Glossary contributor simply by contributing to the project. |
| 18 | +All contributors are expected to follow the [TODO Code of Conduct](https://todogroup.org/code-of-conduct/). |
| 19 | + |
| 20 | +There are a variety of ways you can contribute to the project, including: |
| 21 | + |
| 22 | +- **Content contributors**: everyone who improves existing terms or contributes new ones, |
| 23 | +- **Localization contributors**: those who help translate the glossary into another language, |
| 24 | +- **Helpers**: anyone who helps others on GitHub, Slack, or wherever community members need support, |
| 25 | +- **Ambassadors**: anyone who helps spread the word, educates the community on how to contribute and why they should do so. |
| 26 | + |
| 27 | +Contributors can have multiple roles or focus on one area only. |
| 28 | +**All these contributions are equally important** and help foster a thriving community. |
| 29 | +Please refer to the [How to Contribute](/contribute/) and [Style Guide](/style-guide/) for content and localization contributions. |
| 30 | + |
| 31 | +## 2. Approvers |
| 32 | + |
| 33 | +Approvers provide feedback on PRs and approve them. Any active contributor can become an approver (see [Becoming an approver](#becoming-an-approver)). |
| 34 | +The Glossary differentiates between two approvers: (1) approvers for the English Glossary and (2) approvers for localization teams. |
| 35 | + |
| 36 | +Glossary approvers are expected to: |
| 37 | + |
| 38 | +- Review PRs for technical accuracy, |
| 39 | +- Assign contributors issues and label them appropriately, |
| 40 | +- Provide contributors with feedback and guide them when needed, |
| 41 | +- Proofread and edit submissions. |
| 42 | + |
| 43 | +If an approver is no longer interested in or cannot perform the above duties, they should let the maintainers know and step down. |
| 44 | + |
| 45 | +### English Glossary Approvers |
| 46 | + |
| 47 | +There are three types of approvers: |
| 48 | + |
| 49 | +1) Approvers with a strong technical background, |
| 50 | +2) Approvers with solid writing skills, |
| 51 | +3) Approvers who are proficient in both. |
| 52 | + |
| 53 | +**Technical Approvers**: Individuals with a strong technical background can be approvers without having solid English writing skills. |
| 54 | +However, if they approve a PR on technical merit, they must ensure it is reviewed by an (editor) approver. |
| 55 | + |
| 56 | +**Editors**: Editors proofread terms and ensure they are explained in simple language according to the Style Guide. |
| 57 | +If a term is heavily edited, the editor must request a technical approver to review it again to ensure the meaning wasn't altered. |
| 58 | + |
| 59 | +### Localization Approvers |
| 60 | + |
| 61 | +The Glossary also has localization approvers. These are approvers for one of the localization teams (teams translating the glossary). |
| 62 | +Localization approvers are only permitted to perform approver duties for their own team and have the ability to merge PRs to their dedicated development branch. |
| 63 | +Any localization approver can also become an approver for the English Glossary if they meet the requirements. |
| 64 | + |
| 65 | +### Becoming an Approver |
| 66 | + |
| 67 | +Approver candidates should have a proven track record of submitting high-quality PRs and helping others get their PRs in a mergeable state. |
| 68 | + |
| 69 | +To become an approver, start by expressing interest to existing maintainers. |
| 70 | +Existing maintainers will then ask you to demonstrate the qualifications above by contributing PRs, doing reviews, and doing other such tasks under their guidance. |
| 71 | +After some time of working together, maintainers will decide whether to grant you approver status. |
| 72 | +This decision will be based on your demonstrated level of proficiency and responsiveness. |
| 73 | + |
| 74 | +## 3. Maintainers |
| 75 | + |
| 76 | +Maintainers are approvers who can also merge PRs. Anyone can become a Glossary maintainer (see [Becoming a maintainer](#becoming-a-maintainer)). |
| 77 | +There are certain expectations for maintainers, including: |
| 78 | + |
| 79 | +- Be an active and responsive approver (see above), |
| 80 | +- Help maintain the repository, including site configuration, permission, issue-template, GitHub workflow, among others, |
| 81 | +- Monitor the Glossary Slack channels and help out whenever possible, |
| 82 | +- Regularly attend the [Glossary Working Group meetings](https://www.cncf.io/calendar/) (if timezone permits) |
| 83 | + |
| 84 | +If a maintainer is no longer interested in or cannot perform the duties listed above, they should move themselves to emeritus status. |
| 85 | + |
| 86 | +### Becoming a Maintainer |
| 87 | + |
| 88 | +Maintainers should have a proven track record of being successful approvers and submitting high-quality PRs. |
| 89 | +If their timezone permits, they should also regularly attend the Glossary Working Group meetings. |
| 90 | + |
| 91 | +To become a maintainer, start by expressing interest to existing maintainers. |
| 92 | +Existing maintainers will then ask you to demonstrate the qualifications above by contributing PRs, doing reviews, and doing other such tasks under their guidance. |
| 93 | +After some time of working together, maintainers will decide whether to grant maintainer status. |
| 94 | +This decision will be based on demonstrated level of proficiency and responsiveness. |
| 95 | + |
| 96 | +## Involuntary Removal |
| 97 | + |
| 98 | +Involuntary removal of a contributor happens when responsibilities and requirements aren't met. |
| 99 | +This may include repeated patterns of inactivity, extended periods of inactivity, and/or a violation of the code of conduct. |
| 100 | +This process is important because it protects the community and its deliverables while also opening up opportunities for new contributors to step in. |
| 101 | + |
| 102 | +## Stepping Down/Emeritus Process |
| 103 | + |
| 104 | +If and when contributors' commitment levels change, contributors can consider stepping down (moving down the contributor ladder) vs. |
| 105 | +moving to emeritus status (completely stepping away from the project). |
| 106 | + |
| 107 | +## Stepping Back Into a Role |
| 108 | + |
| 109 | +If and when someone is available to step back into a previous contributor role, project leadership can arrange and consider this. |
0 commit comments