Skip to content

Refine 'gaining commit privileges'.#969

Merged
ezio-melotti merged 10 commits intopython:mainfrom
jaraco:feature/refine-gaining-privileges
Dec 25, 2022
Merged

Refine 'gaining commit privileges'.#969
ezio-melotti merged 10 commits intopython:mainfrom
jaraco:feature/refine-gaining-privileges

Conversation

@jaraco
Copy link
Copy Markdown
Member

@jaraco jaraco commented Oct 14, 2022

During my recent experience nominating someone for commit privileges, I ran into some friction attempting to follow the guidance. This change addresses that friction.

  • Allow the audience to be anybody (not just an individual seeking commit privileges). Avoids use of second-person language.
  • Provide guidance for all involved.
  • Refer to the various actors directly, avoiding passive language. Use 'candidate', 'submitter', and 'approver' to represent the key actors.
  • Move the "cross-post" action into step 1 to indicate better the temporal positition of the action.
  • Summarize the confirmation criterion (2/3 vote) rather than make the reader go to the PEP, which basically indicates 2/3 vote.
  • Include the steering council email, because the submitter may not know it.
  • Normalize the initial approver actions. Previously, council was directed to be "asking for ... a reminder about the Code of Conduct and to report issues to the PSF WG". Now it's two requests and a reminder.
  • Hyperlink "python/voters" instead of the full URL.

- Allow the audience to be anybody (not just an individual seeking commit privileges). Avoids use of second-person language.
- Provide guidance for all involved.
- Refer to the various actors directly, avoiding passive language. Use 'candidate', 'submitter', and 'approver' to represent the key actors.
- Move the "cross-post" action into step 1 to indicate better the temporal positition of the action.
- Summarize the confirmation criterion (2/3 vote) rather than make the reader go to the PEP, which basically indicates 2/3 vote.
- Include the steering council email, because the submitter may not know it.
- Normalize the initial approver actions. Previously, council was directed to be "asking for ... a reminder about the Code of Conduct and to report issues to the PSF WG". Now it's two requests and a reminder.
- Hyperlink "python/voters" instead of the full URL.
(approver) will email the candidate:

- A request for account details as required by
`🔒 python/voters <https://github.com/python/voters>`_
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This "🔒 python/voters" contraction looks good 👍

GitHub does similar: https://github.com/python/voters

jaraco and others added 8 commits December 15, 2022 19:52
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Copy link
Copy Markdown
Member

@CAM-Gerlach CAM-Gerlach left a comment

Choose a reason for hiding this comment

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

A couple final small grammar and clarity tweaks, otherwise LGTM. Thanks @jaraco , this is a big improvement IMO!


#. Once the candidate has provided the pertinent details, the approver will:

- enable various new privileges;
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Ideally, this would be a bit more specific, although I guess approvers are assumed to be sufficiently experienced to just know this information...

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
@ezio-melotti ezio-melotti added the type-feature Additions; New content or section needed label Dec 25, 2022
@ezio-melotti ezio-melotti merged commit 8d36547 into python:main Dec 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type-feature Additions; New content or section needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants