Skip to content

add project contributor role to contributor ladder#22

Open
hone wants to merge 3 commits into
bootc-dev:mainfrom
hone:project-contributor
Open

add project contributor role to contributor ladder#22
hone wants to merge 3 commits into
bootc-dev:mainfrom
hone:project-contributor

Conversation

@hone

@hone hone commented Jun 29, 2026

Copy link
Copy Markdown

Based on discussions from the community WG, I'm proposing adding a project contributor role to the contributor ladder mirror other CNCF projects. This provides a path: Contributor -> Maintainer/Community Manager.

I have some open questions:

  • Where should we list contributors? For now I put it in MAINTAINERS.md, but this feels wrong b/c Project Contributors aren't maintainers. Importantly, they shouldn't be included in the CNCF maintainers list. Should we rename MAINTAINERS.md to something like TEAM.md or create a new file?
  • In the MAINTAINERS.md table, there's a Responsibilities column, for Project Contributors what would that be?
  • For admitting a new Project Contributor to match what we did with maintainers: majority to accept and super majority (2/3rds) to remove. I wasn't sure if you just wanted majority for both since the impact is lower.
  • There was mention of adding a reviewing role to the ladder, but I don't know if we need that much structure yet.

Signed-off-by: Terence Lee <hone02@gmail.com>
@nimbinatus

Copy link
Copy Markdown
Contributor

I think this makes sense. I have a couple thoughts on changes, but I won't make suggestions just yet as I want to respond to your questions.

  • Where should we list contributors? For now I put it in MAINTAINERS.md, but this feels wrong b/c Project Contributors aren't maintainers. Importantly, they shouldn't be included in the CNCF maintainers list. Should we rename MAINTAINERS.md to something like TEAM.md or create a new file?

I've usually found this kind of role (typically something more like "member") to be defined by org membership, tbh. Examples:

  • In the MAINTAINERS.md table, there's a Responsibilities column, for Project Contributors what would that be?

Based on examples like the above, I'd just say "active contributions" as use the inactive categorization you've already laid out as the definition.

  • For admitting a new Project Contributor to match what we did with maintainers: majority to accept and super majority (2/3rds) to remove. I wasn't sure if you just wanted majority for both since the impact is lower.

Personally, I like the lightweight option of (1) open an issue here with details on your contributions (i.e., how do you meet the activity criteria), (2) get two plus-ones from reviewer+ (so maintainer here) from any subproject, then (3) get added to the org with the person doing the work welcoming you to the org and closing the issue as completed. I'm open to suggestions, though.

  • There was mention of adding a reviewing role to the ladder, but I don't know if we need that much structure yet.
    Probably not, especially if contributors can help review with Triage access.

Probably not? But something we'll likely want in the future...

@nimbinatus

Copy link
Copy Markdown
Contributor

Adding the maintainers for review.

@nimbinatus nimbinatus left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Following my prior comment, here's the suggestions I'd make.

Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md
* ability to collaborate with the team,
* understanding of how the team works (policies, processes for testing and code review, etc).

A new Project Contributor can be proposed by an existing Maintainer or by the candidate themselves by opening a PR against [MAINTAINERS.md](./MAINTAINERS.md). The nomination will be approved via lazy consensus or a simple majority vote of the Maintainers.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A new Project Contributor can be proposed by an existing Maintainer or by the candidate themselves by opening a PR against [MAINTAINERS.md](./MAINTAINERS.md). The nomination will be approved via lazy consensus or a simple majority vote of the Maintainers.
A new Project Contributor can be proposed by an existing Maintainer or by the candidate themselves by [opening an issue in the community repo](https://github.com/bootc-dev/community/issues/new/choose). After detailing their activity that meets the criteria above, two or more Maintainers who have worked with the candidate on the project in the named activities must sponsor the candidate by commenting on the issue. Then the new contributor can be added to the org and welcomed on the issue before closing it as completed.

Not sure I exactly like this wording, but this is the vague version. There's a number of examples I linked to in the other comment if you want to reword this :)

@hone hone Jul 1, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nimbinatus what's interesting here is contributors have a lower criteria bar, but there's a requirement that a candidate has to show their activity which is not true for maintainers.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Usually with this kind of wording, the expectation is that a maintainer must maintain the same level of expectation as the rungs lower on the ladder (i.e., in addition, not independent rungs). We could word that more explicitly?

Comment thread MAINTAINERS.md Outdated
Co-authored-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
Signed-off-by: Terence Lee <hone02@gmail.com>
cgwalters
cgwalters previously approved these changes Jul 1, 2026
Comment thread GOVERNANCE.md

A new Project Contributor can be proposed by an existing Maintainer or by the candidate themselves by opening a PR against [MAINTAINERS.md](./MAINTAINERS.md). The nomination will be approved via lazy consensus or a simple majority vote of the Maintainers.

Project Contributors who are approved will be invited to the bootc GitHub organization and granted Triage permissions on the project repositories.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a pretty low permission level. I'd personally like to add a finer grain here in the future; like one thing I can imagine here is for "low risk PRs" a project contributor could approve/merge too e.g.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(Nonblocking for here, just brainstorming)

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How do you determine if something is "low risk"? Is it just a "trust" thing?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm kind of just making things up here but I think it's a combination of basic things like CODEOWNERS plus LLM risk analysis

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or to say it a different way, I would personally like to also require "large" PRs to be reviewed by two maintainers say (or at least 1 maintainer and 1 contributor) etc.

Signed-off-by: Terence Lee <hone02@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants