Skip to content

Conversation

@mdlayher
Copy link
Contributor

@mdlayher mdlayher commented Mar 16, 2018

I propose these changes to our governance process to clarify some of the steps taken when adding Krasi as a new member of the Prometheus team.

@juliusv mentioned this in an email in the group:

Btw., the governance only states about new team members, "Team members are added to the GitHub organization as Owner.". It doesn't state explicitly that they should also be added to the prometheus-team mailing list, although the definition at the top implies it: "Team members: Any members of the private prometheus-team Google group."

It feels like it's worth explicitly stating this. I have also added a couple bullets so that team members have a checklist for adding new members.

I'll create a thread on developers regarding these changes, so that we can gather feedback and comments on the wording, process, etc.

If the response is favorable, I will call a formal vote on the list at a later time.

Please only comment on GitHub for minor changes such as wording, grammer, etc. In depth discussion should take place on the developers thread here, per our governance: https://groups.google.com/forum/#!topic/prometheus-developers/qr9rbdZUsnY.

Copy link
Member

@brancz brancz left a comment

Choose a reason for hiding this comment

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

Generally in favor of more detail. Thanks for taking action on this!

New members may be proposed by any existing member by email to [prometheus-team][team]. It is highly desirable to reach consensus about acceptance of a new member. However, the proposal is ultimately voted on by a formal [supermajority vote](#supermajority-vote).

Team members are added to the [GitHub organization][gh] as _Owner_. They should however respect the maintainers of each project.
If the new member proposal is accepted, the proposed team member should be contacted privately to confirm or deny their acceptance of team membership. If they choose to accept, the following steps should be taken:
Copy link
Member

Choose a reason for hiding this comment

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

"If they choose to accept, the following steps are taken:"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

SGTM.

Copy link
Member

Choose a reason for hiding this comment

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

I would contact them CC'ed to the team list. Abuse is very unlikely here, but there should be a paper trail on this.

Team members are added to the [GitHub organization][gh] as _Owner_. They should however respect the maintainers of each project.
If the new member proposal is accepted, the proposed team member should be contacted privately to confirm or deny their acceptance of team membership. If they choose to accept, the following steps should be taken:

* Team members are added to the [GitHub organization][gh] as _Owner_. They should however respect the maintainers of each project.
Copy link
Member

Choose a reason for hiding this comment

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

The second description is a definition of team member vs. maintainer. Not necessary to re-iterate here I think.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I have no qualms removing this; I just copied the existing sentence from line 35.

@juliusv
Copy link
Member

juliusv commented Mar 18, 2018

👍 from me

RichiH
RichiH previously requested changes Mar 19, 2018
New members may be proposed by any existing member by email to [prometheus-team][team]. It is highly desirable to reach consensus about acceptance of a new member. However, the proposal is ultimately voted on by a formal [supermajority vote](#supermajority-vote).

Team members are added to the [GitHub organization][gh] as _Owner_. They should however respect the maintainers of each project.
If the new member proposal is accepted, the proposed team member should be contacted privately to confirm or deny their acceptance of team membership. If they choose to accept, the following steps should be taken:
Copy link
Member

Choose a reason for hiding this comment

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

I would contact them CC'ed to the team list. Abuse is very unlikely here, but there should be a paper trail on this.

@RichiH
Copy link
Member

RichiH commented Mar 19, 2018

We should also add team members to the lastpass password store.

@RichiH
Copy link
Member

RichiH commented Mar 19, 2018

PS: Once this PR is ready, we will need to vote on it on the list again.

@brian-brazil
Copy link
Contributor

We should also add team members to the lastpass password store.

I don't think we should get to that level of detail in this document, I don't think it's sane to need a vote for every new type of access we have.

@RichiH
Copy link
Member

RichiH commented Mar 19, 2018

Valid point, but then the logical conclusion is that any list is bound to be incomplete and thus misleading.

@brian-brazil
Copy link
Contributor

I'm not saying we shouldn't have a list, I'm saying that the list doesn't belong in this document.

@mdlayher
Copy link
Contributor Author

I've added a new commit that I believe accounts for all feedback given thus far.

My plan is to put this to a vote on Friday in a new thread on prometheus-developers.

In the mean time, please keep non-wording/spelling/grammar discussion on the mailing list thread, thanks!

@brancz
Copy link
Member

brancz commented Mar 19, 2018

lgtm

New members may be proposed by any existing member by email to [prometheus-team][team]. It is highly desirable to reach consensus about acceptance of a new member. However, the proposal is ultimately voted on by a formal [supermajority vote](#supermajority-vote).

If the new member proposal is accepted, the proposed team member should be contacted privately to confirm or deny their acceptance of team membership. If they choose to accept, the following steps should be taken:
If the new member proposal is accepted, the proposed team member should be contacted privately via email to confirm or deny their acceptance of team membership. This email should also be CC'd to [prometheus-team][team] for record keeping purposes.
Copy link
Member

Choose a reason for hiding this comment

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

s/should/will/

@RichiH
Copy link
Member

RichiH commented Mar 22, 2018

Added a final nitpick.

We should freeze this PR and then toss it onto the ML.

@mdlayher
Copy link
Contributor Author

All done. Starting a vote thread now.

@mdlayher
Copy link
Contributor Author


* Team members are added to the list of team members in this document.

* New team members are announced on the [developers mailing list][devs] by an existing team member.
Copy link
Member

Choose a reason for hiding this comment

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

Formatting nit: Blank lines between list items create <p>-wrapped items. It looks a bit weird as the next list in this section does not have blank lines between list items. (However, the list at the top has it, perhaps deliberately so.)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I believe that the markdown linting tool I have installed in VSCode recommended this formatting.

I don't feel strongly either way, but it is odd that we already have both styles in place.

New members may be proposed by any existing member by email to [prometheus-team][team]. It is highly desirable to reach consensus about acceptance of a new member. However, the proposal is ultimately voted on by a formal [supermajority vote](#supermajority-vote).

Team members are added to the [GitHub organization][gh] as _Owner_. They should however respect the maintainers of each project.
If the new member proposal is accepted, the proposed team member should be contacted privately via email to confirm or deny their acceptance of team membership. This email will also be CC'd to [prometheus-team][team] for record keeping purposes.
Copy link
Member

Choose a reason for hiding this comment

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

Nit: record-keeping purposes.

@mdlayher
Copy link
Contributor Author

The vote for these changes has passed with 15 affirmative votes! Will wait for a final PR approval from a member of the team, then merge.

@RichiH
Copy link
Member

RichiH commented Mar 26, 2018 via email

@juliusv juliusv dismissed RichiH’s stale review March 26, 2018 15:18

Comments are addressed, LGTM via email.

@juliusv juliusv merged commit 3e28220 into master Mar 26, 2018
@juliusv juliusv deleted the mdl-governance-clarifications branch March 26, 2018 15:19
aylei pushed a commit to aylei/docs that referenced this pull request Oct 28, 2019
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.

6 participants