|
| 1 | +_model: page |
| 2 | +--- |
| 3 | +_template: page-with-toc.html |
| 4 | +--- |
| 5 | +title: Community Team: Project Roles |
| 6 | +--- |
| 7 | +body: |
| 8 | +This page serves as a guide for project-based roles on CC's [Community Team][communityteam]. |
| 9 | + |
| 10 | +Roles other than "Project Maintainer" are coming soon! |
| 11 | + |
| 12 | +## Project Maintainers |
| 13 | + |
| 14 | +Before getting started with the rest of the guidelines, please review the [Community Team][communityteam] page and familiarize yourself with the roles and requirements for each role, evaluation criteria, and the privilege and role de-escalation process. |
| 15 | + |
| 16 | +### Responsibilities |
| 17 | +As a Project Maintainer, your responsibilities are as follows: |
| 18 | + |
| 19 | +* **Review pull requests (PRs):** You are expected to review incoming pull requests regularly (we aim to review all pull requests within [within three business days][pullrequestguidelines]). |
| 20 | +* **Recognize work as "Great Contribution":**You are expected to pay attention to contributions to your repositories, and apply “Great Contribution” labels as needed. For more information about this, see the “Great Contributions” section below. |
| 21 | +* **Decide on Community Team applications:** You are expected to make the final decision on Community Team applications for your project. |
| 22 | +* **Communicate with the applicant and the OSCC promptly:** You are expected to reach out to applicants for Community Team directly and let them know the status of their application. |
| 23 | + * We want to get back to applicants within seven business days of application, if possible. If this is not possible, you should reach out to the applicant just letting them know that it’s taking a little longer than usual (could be due to internal discussion taking a while, other things taking precedent, etc.), and that we’re working on it. |
| 24 | + * You are expected to communicate with the Open Source Community Coordinator promptly (within three business days) when they reach out to you about a new Community Team application or other related matter. |
| 25 | + * You should also notify the OSCC of your decision about the Community Team application. |
| 26 | +* **Let contributors know about Community Team:** If you notice a strong contributor, you should notify them of the existence of Community Team, provide them with the link to the Community Team page on the CC Open Source site, and encourage them to apply. |
| 27 | + |
| 28 | +[pullrequestguidelines]: /contributing-code/pr-guidelines |
| 29 | +[communityteam]: /community/community-team |
| 30 | + |
| 31 | + |
| 32 | +### Great Contributions |
| 33 | +Great Contributions |
| 34 | +“Great Contributions” are evaluated subjectively. If you notice that a contribution was of particularly high quality, you should mark it as a “Great Contribution”. |
| 35 | + |
| 36 | +Guidelines for what to mark as a “Great Contribution”: |
| 37 | +* A substantial PR (e.g. not fixing two links in a README. work should reasonably take an hour or more (assuming they’re not familiar with the project) |
| 38 | +* Shows hard work |
| 39 | +* Responsive to feedback |
| 40 | + |
| 41 | +How to label “Great Contributions”: |
| 42 | +* Assign the issue or PR to whoever made the great contribution. |
| 43 | +* Apply the “Great Contribution” label to the issue or PR. |
| 44 | +* Notify whoever made the great contribution that it has been recognized as such. |
| 45 | + |
| 46 | + |
| 47 | +### Reviewing Applications |
| 48 | +Applications for Community Teams roles will be sent to you individually by the Open Source Community Coordinator. The OSCC has ensured that the bare requirements for the position are met. If bare requirements are not met, you will be notified how so when you receive the application from the OSCC. |
| 49 | + |
| 50 | +From here, you should review the application and the applicant’s contributions based on the evaluation criteria. As a maintainer, you have lots of discretion here. If an applicant meets the requirements, but you do not think they are ready for the role they’ve applied for, you can choose to grant a role with fewer privileges, or not grant a role at all. |
| 51 | + |
| 52 | +No matter the decision, you should do the following things: |
| 53 | +* Notify the OSCC of your decision. Please include the applicant’s name, the role they applied for, and if they applied for a project based role, the project they applied to. From here, the OSCC will help coordinate permissions and role management. |
| 54 | +* Notify the applicant of your decision. If you choose to grant them the role they applied for, then send a congratulatory message. If you choose to not grant them the role at all, or to grant one with fewer privileges, you should construct some brief feedback as to why their application was denied, either in part or in full. There’s a template for this type of feedback available in the Community Team Google Shared Drive that you have access to. |
| 55 | +* Respond promptly to nominated “Great Contributions” and applications for roles once they make their way to you. We would like to target seven business days or less from time of application to time of decision, but this is somewhat flexible. |
| 56 | + |
| 57 | + |
| 58 | +### Additional Notes |
| 59 | +All Community Team work is done on a volunteer basis. Team members may pick up tasks and help out here and there if they would like, but they should not be expected to use all of their privileges all the time. |
| 60 | + |
| 61 | +You have a big license for discretion within the Community Team. All applicants for all roles will need to be approved by you personally, and you may choose to deny an application based on subjective criteria even if the applicant meets the hard requirements. |
| 62 | + |
| 63 | +Here are some other miscellaneous things: |
| 64 | +* Issue submission requirements are org-wide, but PR requirements are not. Applicants should be submitting PRs for the repo they are aiming to get privileges for. |
| 65 | +* If two repos are closely related to each other (ex. catalog and catalog api), or if work in repo X also regularly includes work in repo Y, project maintainers can collaborate to grant roles to a contributor in both repos at once. |
| 66 | +* Repositories may opt out of granting roles depending on the nature of the repository. |
| 67 | + |
| 68 | +As a maintainer, you have the ability to make some repository-specific allowances. These include the following: |
| 69 | +* Issue and PR requirements can vary by repository depending on traffic. If a maintainer wants to mandate different numbers for their repository, they should state these requirements in the repo’s README. |
| 70 | +* Maintainers may expand on what is counted as a “Contribution” if there is some type of work specific to that repository. |
| 71 | +* Specific privileges may be granted per-repo by maintainers depending on the type of work taking place in that repo (ex. Issue research in cccatalog). |
0 commit comments