|
| 1 | +# gittuf Contributor ladder |
| 2 | + |
| 3 | +gittuf's contributor ladder is loosely inspired by the OpenSSF [Scorecard |
| 4 | +Contributor Ladder]. This document details how community members may advance to |
| 5 | +more-involved roles within the gittuf project. |
| 6 | + |
| 7 | +- [Roles](#roles) |
| 8 | + - [Community members](#community-members) |
| 9 | + - [Maintainers](#maintainers) |
| 10 | +- [Inactive members](#inactive-members) |
| 11 | + |
| 12 | +## Roles |
| 13 | + |
| 14 | +### Community members |
| 15 | + |
| 16 | +Community members engage with gittuf, contributing their time and energy in |
| 17 | +discussions or just generally helping out. |
| 18 | + |
| 19 | +#### Pre-requisites |
| 20 | + |
| 21 | +- Must follow the [OpenSSF Code of Conduct] |
| 22 | +- Must follow the [Contribution Guide] |
| 23 | + |
| 24 | +#### Responsibilities |
| 25 | + |
| 26 | +- Keep it up! |
| 27 | + |
| 28 | +### Maintainers |
| 29 | + |
| 30 | +Maintainers are responsible for the project's overall health. They are the only |
| 31 | +ones who can approve and merge code contributions. |
| 32 | + |
| 33 | +**Defined by:** "Maintain" permissions in the project |
| 34 | + |
| 35 | +#### Pre-requisites |
| 36 | + |
| 37 | +- Reviewed at least 10 substantial PRs to the codebase |
| 38 | +- Reviewed or got at least 30 PRs merged to the codebase |
| 39 | + |
| 40 | +#### Responsibilities |
| 41 | + |
| 42 | +- Demonstrate sound technical judgment |
| 43 | +- Maintain project quality control via code reviews |
| 44 | + - Focus on holistic acceptance of contribution |
| 45 | +- Be responsive to review requests |
| 46 | +- Mentor contributors |
| 47 | +- Approve and merge code contributions as appropriate |
| 48 | +- Participate in gittuf community meetings, if possible |
| 49 | +- Facilitating gittuf-specific community meetings, if possible and comfortable |
| 50 | + |
| 51 | +#### Privileges |
| 52 | + |
| 53 | +- Maintainer status may be a precondition to accepting especially large code |
| 54 | + contributions |
| 55 | + |
| 56 | +#### Promotion process |
| 57 | +- Sponsored by a maintainer |
| 58 | + - With no objections from other maintainers |
| 59 | + - Done through PR to update the MAINTAINERS.md file |
| 60 | +- May self-nominate or be nominated by a maintainer |
| 61 | + - In case of self-nomination, sponsor must comment approval on the PR |
| 62 | + |
| 63 | +## Inactive members |
| 64 | +A core principle in maintaining a healthy community is encouraging active |
| 65 | +participation. It is inevitable that a contributor's focus will change over time |
| 66 | +and there is no expectation they'll actively contribute forever. |
| 67 | + |
| 68 | +Any contributor at any level described above may write an issue (or PR, if |
| 69 | +MAINTAINERS.md changes are necessary) asking to step down to a lighter-weight |
| 70 | +tier or to depart the project entirely. Such requests will hopefully come after |
| 71 | +thoughtful conversations with the rest of the team and with sufficient |
| 72 | +forewarning for the others to prepare. However, sometimes "life happens". |
| 73 | +Therefore, the change in responsibilities will be understood to take immediate |
| 74 | +effect, regardless of whether the issue/PR has been acknowledged or merged. |
| 75 | + |
| 76 | +However, should a Maintainer be deemed inactive for a significant period, any |
| 77 | +Community Member or above may write an issue/PR requesting their removal from |
| 78 | +the ranks (and `@mentioning` the inactive contributor in the hopes of drawing |
| 79 | +their attention). The request must receive support (in comments) from a majority |
| 80 | +of Maintainers to proceed. |
| 81 | + |
| 82 | +[OpenSSF Code of Conduct]: https://openssf.org/community/code-of-conduct/ |
| 83 | +[Contribution Guide]: https://github.com/gittuf/gittuf/blob/main/CONTRIBUTING.md |
| 84 | +[Scorecard Contributor Ladder]: https://github.com/ossf/scorecard/blob/main/CONTRIBUTOR_LADDER.md |
0 commit comments