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

KEP-3344: Add Release Team Roster KEP #3347

Closed
wants to merge 7 commits into from

Conversation

JamesLaverack
Copy link
Member

  • One-line PR description: Add first draft of KEP 3344
  • Other comments: N/A

@k8s-ci-robot
Copy link
Contributor

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@k8s-ci-robot k8s-ci-robot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Jun 7, 2022
@k8s-ci-robot k8s-ci-robot requested review from cpanato and puerco June 7, 2022 03:47
@k8s-ci-robot k8s-ci-robot added kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory sig/release Categorizes an issue or PR as relevant to SIG Release. labels Jun 7, 2022
@JamesLaverack
Copy link
Member Author

/assign

@saschagrunert
Copy link
Member

@JamesLaverack thank you for outlining this! Feel free to ping folks when this is ready for review.

Copy link
Member

@kikisdeliveryservice kikisdeliveryservice left a comment

Choose a reason for hiding this comment

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

Minor comments on the draft. This is awesome @JamesLaverack ❤️

- The release team having some degree of 'churn' is natural and expected.
An entirely static, or effectively static, team is not desirable.

Balancing these desires, this KEP introduces a stable

Choose a reason for hiding this comment

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

I think this sentence needs an ending? ;)

Copy link
Member Author

Choose a reason for hiding this comment

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

I just replaced the whole sentance. I don't know what thought I was half way though. 😂

keps/sig-release/3344-refine-release-team/README.md Outdated Show resolved Hide resolved
- when the KEP was retired or superseded
-->

## Drawbacks

Choose a reason for hiding this comment

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

Probably this section should be filled out eventually.

Copy link
Member Author

Choose a reason for hiding this comment

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

I've added a few obvious ones. More are welcome!

Not applicable.

### Graduation Criteria

Choose a reason for hiding this comment

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

This is essentially a straight to GA process change right?

Copy link
Member Author

Choose a reason for hiding this comment

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

Good point. I agree. I've updated it.

I don't think there's any way to do an alpha/beta of this.

keps/sig-release/3344-refine-release-team/README.md Outdated Show resolved Hide resolved
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: JamesLaverack
Once this PR has been reviewed and has the lgtm label, please assign saschagrunert for approval by writing /assign @saschagrunert in a comment. For more information see:The Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@JamesLaverack JamesLaverack marked this pull request as ready for review July 21, 2022 14:39
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jul 21, 2022
@JamesLaverack
Copy link
Member Author

Okay @saschagrunert @kikisdeliveryservice. I think this is ready for a serious review. :D

keps/sig-release/3344-refine-release-team/README.md Outdated Show resolved Hide resolved
An entirely static, or effectively static, team is not desirable.

Balancing these desires, this KEP introduces a long-lived "roster" of release team members.
This roster is used to assemble release teams instead of a new shadow survey each time.
Copy link
Member

Choose a reason for hiding this comment

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

I think we should not replace the shadow survey for new folks who wanna join, so let's clarify:

Suggested change
This roster is used to assemble release teams instead of a new shadow survey each time.
This roster is used to assemble release teams with recurring contributors in addition to the shadow survey for new folks.

### Release Team Roster

We will add to SIG Release a "Release Team Roster".
The list of roster members will be maintained in a YAML file in https://github.com/kubernetes/sig-release under a new `release-team/roster` directory.
Copy link
Member

Choose a reason for hiding this comment

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


We will add to SIG Release a "Release Team Roster".
The list of roster members will be maintained in a YAML file in https://github.com/kubernetes/sig-release under a new `release-team/roster` directory.
People on the roster can be in one of three roles: Shadow, Member, or Emeritus.
Copy link
Member

Choose a reason for hiding this comment

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

How about keeping the shadows as-is and only use "Member" or "Emeritus"? This way shadows can join the roster after a cycle, which provides a contributor ladder.


### Shadow Survey

The per-release shadow selection survey will be replaced with a rolling "expression of interest" form.
Copy link
Member

Choose a reason for hiding this comment

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

I think we should do both: Selecting new shadows and re-evaluating the existing roster. This makes it easier for new contributors to join because the folks from the roster will not use the shadow form any more.

People on the roster can be in one of three roles: Shadow, Member, or Emeritus.

At the time of creation, all former role leads or release leads from any release will be added as emeritus members, or a member if they want.
The 1.25 EA will lead discussions around which shadows from 1.25 should be placed at the member or shadow level on the release team roster.
Copy link
Member

Choose a reason for hiding this comment

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

nit: let's avoid building language barriers:

Suggested change
The 1.25 EA will lead discussions around which shadows from 1.25 should be placed at the member or shadow level on the release team roster.
The 1.25 Emeritus Advisor (EA) will lead discussions around which shadows from 1.25 should be placed at the member or shadow level on the release team roster.

@JamesLaverack JamesLaverack changed the title KEP-3344: Add First KEP Draft KEP-3344: Add Release Team Roster KEP Jul 26, 2022
@saschagrunert
Copy link
Member

Hey @JamesLaverack, any update on this KEP? :)

@JamesLaverack
Copy link
Member Author

JamesLaverack commented Aug 26, 2022

Hey @JamesLaverack, any update on this KEP? :)

Hey @saschagrunert. I've been very busy personally over the past few weeks, but I will be able to dedicate time to this over the coming weeks. :) Current plan is to get this merged ahead of 1.17 1.27 in January.

@saschagrunert
Copy link
Member

@JamesLaverack awesome, thank you for the update (assuming you mean k8s v1.27)!

@k8s-ci-robot
Copy link
Contributor

@JamesLaverack: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
pull-enhancements-verify ff10b22 link true /test pull-enhancements-verify

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.

@JamesLaverack
Copy link
Member Author

@saschagrunert I've updated the KEP now, thank you for your patience.

We discussed sending an email to dev@kubernetes.io about the change to solicit wider feedback. I'd like to do that, but I don't want to confuse people who are waiting on 1.26 shadow survey responses.

My understanding is that the 1.26 survey has closed, and responses are due on the 12th. (cc @palnabarun). Would it be best to send an email about this KEP the day after on Tuesday 13th September?

@palnabarun
Copy link
Member

@JamesLaverack -- by 1.26 shadow survey, do you mean Release Team Shadow Applications for 1.26?

@JamesLaverack
Copy link
Member Author

@JamesLaverack -- by 1.26 shadow survey, do you mean Release Team Shadow Applications for 1.26?

Yes that's what I mean. Sorry I wasn't clear.

@palnabarun
Copy link
Member

No worries. It's closed already. The last date was 2nd September.

@JamesLaverack
Copy link
Member Author

Sure, then I'm thinking of sending this to dev@kubernetes.io:

Hi Kubernetes Community,

Every Kubernetes release has a release team, a group contributors who work together to run the 'mechanics' of the release process for that release. SIG Release has overall responsibility for assembling this team for each release.

In order to better meet the needs of returning contributors, SIG Release is consdiering amending the team selection process for future release teams. We'd appreciate review, thoughts, or concerns from the commuity on this change in process. You can find the proposal under KEP-3344 [0], with a draft KEP on this PR [1].

All feedback is welcomed!
Thanks,

[0] https://github.com/kubernetes/enhancements/issues/3344
[1] https://github.com/kubernetes/enhancements/pull/3347

Any advice on tigtening up the language here?

@leonardpahlke
Copy link
Member

leonardpahlke commented Oct 4, 2022

I like your text already LGTM :) I rephrased it below just for inspiration if you are not yet sure about your version 🙂

[...]

For each Kubernetes release, sig-release assembles a release team to work on the internal mechanisms for publishing the release.
This process has worked well in the past, but with each release we've collected small pieces of feedback, and now we think it's time to bundle all that feedback into a KEP for a slightly bigger change for the release team.

Primarily to better meet the needs of returning contributors. sig-release is considering changing the team selection process by introducing a pool of stable release team members for future release teams.

We'd appreciate review, [...]

@justaugustus
Copy link
Member

[...] I'm thinking of sending this to dev@kubernetes.io

@JamesLaverack -- please hold any comms about this for @kubernetes/sig-release-leads review of the KEP.

I'm generally -1 for long-standing rosters on the Release Team side, so would like review the content before this goes any wider.

(One of the reasons: staffing has been tough over the last few years)
/assign @saschagrunert @cpanato @puerco @jeremyrickard @justaugustus

Comment on lines +225 to +228
- Continue to provide an "on ramp" for new community members.
- Provide a more streamlined process for release team shadows, including easier return into future release teams.
- Provide a "stable" position that a member may continue to be on release teams if they wish.
- Better handle contributors who wish to take breaks from the team, and then return.
Copy link
Member

Choose a reason for hiding this comment

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

If @kubernetes/sig-release-leads are -1 on the stable roster, then we could also refocus the KEP to:

Suggested change
- Continue to provide an "on ramp" for new community members.
- Provide a more streamlined process for release team shadows, including easier return into future release teams.
- Provide a "stable" position that a member may continue to be on release teams if they wish.
- Better handle contributors who wish to take breaks from the team, and then return.
- Continue to provide an "on ramp" for new community members.
- Provide a more streamlined process for release team shadows, including easier return into future release teams.
- Better handle contributors who wish to take breaks from the team, and then return.

@JamesLaverack
Copy link
Member Author

We discussed this KEP in the SIG Release meeting on Tuesday 11th October 2022, see the notes for the full discussion.

My takeaway from that meeting is that there were a number of people with concerns or who were -1, and a number of people who were ambivilent, but few +1s. As a result I've taken that as a signal that in it's current form it's not worth taking forward.

A few of the concerns raised:

  • That contributors may feel pressured into contributing every cycle, or that this is the expectation.
  • That there will be fewer slots available for new contributors if a roster is present.

One of my goals with this process was to make it so that 'roster' members could feel safe taking breaks without worrying about "falling off" the release team, and the coditifcation that a team be built from both roster members and new contributors is the same as what we do now. I feel that the term "roster" is perhaps part of the issue, and is setting expectations that I didn't intend. That's not to say that this propsal isn't flawed of course, or that those concerns are purely language based. Purely that the language used isn't helping.

At the meeting there was general agreement that the experience for returning contributors in the release team could be improved, so I think I'm going to take @saschagrunert's advice above and refocus on improving that experience. We already provide a separate flow in the shadow application form for this, but I think more could be done. Given the removal of a 'roster' in this proposal, how can we better facilitate returning members, especially members who take breaks?

@JamesLaverack
Copy link
Member Author

After further reflection, I don't think there's support for this more widely in the SIG. I'm closing this for now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory sig/release Categorizes an issue or PR as relevant to SIG Release. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants