-
Notifications
You must be signed in to change notification settings - Fork 1.5k
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
Getting commit access #4246
Getting commit access #4246
Conversation
074b5ac
to
9a76c17
Compare
9a76c17
to
c4364ac
Compare
Note, looking at Commit acess:
So if we're basing this purely on PR activity, that would mean removing commit access for everyone but chandlerc, geoffromer, jonmeow, josh11b, and zygoloid. |
c4364ac
to
53d0792
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mostly wording tweaks... but maybe @dwblaikie can also help with wording as he's been involved in similar discussions in the LLVM community?
Co-authored-by: Chandler Carruth <[email protected]>
Co-authored-by: Chandler Carruth <[email protected]>
Co-authored-by: Chandler Carruth <[email protected]>
Co-authored-by: Chandler Carruth <[email protected]>
Co-authored-by: Chandler Carruth <[email protected]>
I'm trying to use this just to document the de facto state. This is linked to #4246, but I'm trying to keep the two arranged to allow independent merges.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks good to me. No real comments on the policy or approach, just some minor wording things.
I do worry a little that having people self-nominate or ask their reviewer for commit access might lead to some awkward conversations if we think they're not ready yet, and might also lead to some forms of self-nomination bias, but I don't have a better suggestion, so I'm happy to go with this.
docs/project/commit_access.md
Outdated
Note that developers with commit access are not required to do reviews or help | ||
with approving and merging PRs. It can still be useful to allow authors to fix | ||
trivial PR comments after approval and then merge their own PR, for example | ||
because the review noted a minor typo, or to resolve merge conflicts. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I did not understand this paragraph. (For what it's worth, I think the rest of the text works fine without it.)
First sentence: is this saying
- Commit access is not accompanied with a responsibility to do reviews or help with approving and merging PRs. (Developers with commit access are not required to [do certain things] as a condition of their commit access)
or - Reviews and approving or merging PRs can be done without the help of a developer with commit access. (Developers with commit access are not required in order to [do certain things])
Second sentence: What are the consequences of this being useful? Is some particular action encouraged or discouraged, or some policy or advice we want to give here? How is this connected to what we said in the first sentence?
Also, can authors without commit access merge their own PRs after approval? I thought that merging PRs, even once approved, still requires commit access?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
FYI, there was some discussion about this paragraph here: #4246 (comment)
And...
Also, can authors without commit access merge their own PRs after approval? I thought that merging PRs, even once approved, still requires commit access?
I believe they cannot -- and I believe enabling this is a primary motivation for granting commit access.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Authors without commit access haven't ever been able to merge changes.
Also, recently actions became more restrictive for security reasons. I think in the past, a contributor only needed "approve and run" on their first PR. I'm not sure if there's any threshold where "approve and run" is no longer needed now.
So the present state is that people without commit access require assistance in order to both run actions and merge commits.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Note, rephrased the paragraph again.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! The new phrasing works for me.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry, one small edit, "smooth over" -> "ease" due to possible connotations.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Approving for leads (and confirmed with all three FWIW, given the nature of this). Thanks!
Establish a process for getting commit access. We will: - Grant access based on a developer's commit history. - Someone with commit access should nominate, and a contributor may ask. - A lead will approve nominations. Only one lead is needed. - Remove commit access once someone is idle for 6 months. - "Idle" means no significant project activity on any of GitHub, Discord, or in meetings. - Access removed due to being idle will be restored on request. --------- Co-authored-by: Chandler Carruth <[email protected]>
Establish a process for getting commit access. We will: - Grant access based on a developer's commit history. - Someone with commit access should nominate, and a contributor may ask. - A lead will approve nominations. Only one lead is needed. - Remove commit access once someone is idle for 6 months. - "Idle" means no significant project activity on any of GitHub, Discord, or in meetings. - Access removed due to being idle will be restored on request. --------- Co-authored-by: Chandler Carruth <[email protected]>
Establish a process for getting commit access. We will:
or in meetings.