Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Committer status #48

Open
evanp opened this issue Nov 11, 2024 · 5 comments · May be fixed by #51
Open

Committer status #48

evanp opened this issue Nov 11, 2024 · 5 comments · May be fixed by #51

Comments

@evanp
Copy link
Contributor

evanp commented Nov 11, 2024

There's a section in the "Decision process" about making decisions. It proposes a role in the group, "Committer", gives a light definition of how it might be granted, and then defines what role it would play:

This group will seek to make decisions where there is consensus. Groups are free to decide how to make decisions (e.g. Participants who have earned Committer status for a history of useful contributions assess consensus, or the Chair assesses consensus, or where consensus isn't clear there is a Call for Consensus [CfC] (see below) to allow multi-day online feedback for a proposed course of action). It is expected that participants can earn Committer status through a history of valuable discursive contributions as is common in open source projects. After discussion and due consideration of different opinions, a decision should be publicly recorded (where GitHub is used as the resolution of an Issue).

If substantial disagreement remains (e.g. the group is divided) and the group needs to decide an Issue in order to continue to make progress, the Committers will choose an alternative that had substantial support (with a vote of Committers if necessary). Individuals who disagree with the choice are strongly encouraged to take ownership of their objection by taking ownership of an alternative fork. This is explicitly allowed (and preferred to blocking progress) with a goal of letting implementation experience inform which spec is ultimately chosen by the group to move ahead with.

I think we should give this role its own section, since it seems pretty important. I think we should also switch the language about how Committers can get the role from an expectation to a more declarative form. Here's some proposed language:

Committers

A Committer is authorized to make changes to one or more GitHub repositories that are managed by the group. Participants can earn Committer status through a history of useful contributions. Granting Committer status is made through consensus, as discussed in "Decision process". There is no limit to the number of Committers in the group or on a repository. There is no time limit on Committer status. Each repository should have at least one active Committer. Chair(s) can revoke Committer status for any reason. A Committer can give up the role voluntarily.

If this section is added, we can take out the definitions from the "Decision process" section:

This group will seek to make decisions where there is consensus. Groups are free to decide how to make decisions (e.g. Committers assess consensus, or the Chair assesses consensus, or where consensus isn't clear there is a Call for Consensus [CfC] (see below) to allow multi-day online feedback for a proposed course of action). After discussion and due consideration of different opinions, a decision should be publicly recorded (where GitHub is used as the resolution of an Issue).

@evanp
Copy link
Contributor Author

evanp commented Dec 7, 2024

We discussed this in the CG meeting on Dec 6. It seems like general consensus was that it made sense, but there was a sticking point on the term used. Some proposed names:

  • "Editor"
  • "Contributor"
  • The stage process uses the word "champion", which is similar
  • We've used "task force lead" previously

I'm not married to any one term, but I think the mechanical definition "committer" is the clearest one. A committer can commit to a GitHub repo. That gives a certain level of control over a document, diagram, or codebase.

@evanp
Copy link
Contributor Author

evanp commented Dec 14, 2024

@tantek did you have some feedback in here?

@evanp
Copy link
Contributor Author

evanp commented Dec 14, 2024

@bumblefudge you used the term "convener" in the task force description. Is that right?

@evanp
Copy link
Contributor Author

evanp commented Dec 14, 2024

Honestly, I think having three roles in the CG makes a lot of sense:

  • Chair: overall organization, managing consensus, hosting CG meetings, outreach, dealing with problem participants.
  • Committer: can manage GitHub repositories, merge PRs, close issues. Need at least one for a task force.
  • Participant: can contribute, attend meetings, make PR submissions, open issues, write code, write text.

A task force should have a GitHub repository, one or more Committers, and zero or more other Participants.

@nightpool
Copy link

nightpool commented Dec 14, 2024 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants