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

community, wg, template: create wg templates #301

Merged
merged 5 commits into from
Sep 24, 2024

Conversation

dhiller
Copy link
Contributor

@dhiller dhiller commented Jun 5, 2024

What this PR does / why we need it:

This PR:

  • updates the document GOVERNANCE.md that describes SIGs and WGs.
  • creates a template for working group definitions, aligned to how SIG templates currently look.

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Fixes #

Special notes for your reviewer:

/cc @oshoval @fabiand

Checklist

This checklist is not enforcing, but it's a reminder of items that could be relevant to every PR.
Approvers are expected to review this list.

Release note:


@kubevirt-bot kubevirt-bot added the dco-signoff: yes Indicates the PR's author has DCO signed all their commits. label Jun 5, 2024
@dhiller
Copy link
Contributor Author

dhiller commented Jun 5, 2024

/cc @iholder101 @lyarwood @chandramerla

@kubevirt-bot
Copy link

@dhiller: GitHub didn't allow me to request PR reviews from the following users: chandramerla.

Note that only kubevirt members and repo collaborators can review this PR, and authors cannot review their own PRs.

In response to this:

/cc @iholder101 @lyarwood @chandramerla

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-sigs/prow repository.

@fabiand
Copy link
Member

fabiand commented Jun 5, 2024

Thanks, Daniel!

@dhiller
Copy link
Contributor Author

dhiller commented Jun 5, 2024

/cc @aburdenthehand

SIGS_AND_WGS.md Outdated

## WG

A **WG (Working Group)** is a group of people that owns a more specific topic within the project, possibly touching the scope of more than one SIG, with whom the WG interacts.
Copy link
Member

Choose a reason for hiding this comment

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

I'm against redefining the k8s meaning of a WG here by suggesting that ownership is possible outside of a SIG [1][2].

As I've suggested elsewhere [3] we can avoid this by just using subprojects within a SIG [4] and keep the k8s definition of a WG to be a multi SIG collaboration vehicle.

[1] https://github.com/kubernetes/community/blob/master/governance.md#working-groups
[2] https://github.com/kubernetes/community/blob/master/committee-steering/governance/wg-governance.md#is-it-a-working-group-yes-if
[3] #299 (comment)
[4] https://github.com/kubernetes/community/blob/master/governance.md#subprojects

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@lyarwood in Kubernetes WGs are short-lived, and I don't think that this serves node architecture related matters well (for which the initial PR was created), since for that matter clearly an ownership needs to exist in the longer term.

Therefore I have refrained from copying the k8s definitions.

Aside of that I am not talking about specific code ownership here (I agree that this is restricted to SIGs IMHO), but rather about topic ownership. Maybe since I am not a native speaker this is just a matter of words, so I could use some advice about how to rephrase it.

Copy link
Member

@lyarwood lyarwood Jun 5, 2024

Choose a reason for hiding this comment

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

@dhiller processes and deliverables are all also ultimately owned by a SIG within k8s thus my suggestion again to use a SIG sub project instead of redefining the k8s WG definition. These sub projects also have leads and owners so should accommodate what you want to achieve in #298. I'm working through an example for instance types under SIG Compute within kubevirt/kubevirt#12062 and #302 FWIW.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

First of all: what is the problem with redefining WGs for KubeVirt?

Second: Actually, when looking at the document you provided, the sense of the above sentence isn't even redefining it, but rather just avoiding the phrase "short-lived", no?

In that way, and also looking at the document, I think that working group is perfectly right for node architecture, since it actually spans multiple SIGs.

And the sentence explicitly says "owns a more specific topic" and says nothing about code ownership, so again - what is wrong with that sentence?

Please help, thanks :)

Copy link
Member

Choose a reason for hiding this comment

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

First of all: what is the problem with redefining WGs for KubeVirt?

I just don't understand why it's required when the existing and well understood (at least across CNCF) definitions of k8s provide everything we need IMHO.

Second: Actually, when looking at the document you provided, the sense of the above sentence isn't even redefining it, but rather just avoiding the phrase "short-lived", no?

That and suggesting ownership of a topic instead of being targeted at resolving a specific problem.

In that way, and also looking at the document, I think that working group is perfectly right for node architecture, since it actually spans multiple SIGs.

They definitely are for organising around a defined problem like initially standing up a new architecture across multiple SIGs yes but the on-going ownership of the topic, processes and deliverables should still reside in a SIG IMHO with specific architectures listed as sub projects.

And the sentence explicitly says "owns a more specific topic" and says nothing about code ownership, so again - what is wrong with that sentence?

As I tried to say before SIGs own more than just code and WGs in k8s own nothing.

Please help, thanks :)

FWIW I've not received any positive feedback on my stance here or in other PRs so it's likely that I'm standing alone on this hill.

Copy link
Member

@lyarwood lyarwood left a comment

Choose a reason for hiding this comment

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

Looks good, I'd still like to drop the Code, Binaries and Services section and just leave the generic in and out of scope parts.

wg-TEMPLATE/wg-charter-template.md Outdated Show resolved Hide resolved
Copy link
Member

@EdDev EdDev left a comment

Choose a reason for hiding this comment

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

IIUC the original reasoning to introduce the WG concept originated from the need to formalize code ownership of smaller scoped groups (than SIGs).

After @lyarwood clarified the difference between a WG and a subproject, the original reasoning is lost.

IMO there is a need to clarify the new reasoning to establish WG in Kubevirt with examples to such groups that are needed.
At the moment, I’m not familiar with a group of members that meet and discuss cross-SIG topics (that is not owned by a specific SIG). Is there something like this?

On the other hand, the original need for a more granular code ownership is still needed. In that regard, I agree with @lyarwood that we need to define subprojects in Kubevirt.

@lyarwood
Copy link
Member

lyarwood commented Jun 7, 2024

IIUC the original reasoning to introduce the WG concept originated from the need to formalize code ownership of smaller scoped groups (than SIGs).

After @lyarwood clarified the difference between a WG and a subproject, the original reasoning is lost.

IMO there is a need to clarify the new reasoning to establish WG in Kubevirt with examples to such groups that are needed. At the moment, I’m not familiar with a group of members that meet and discuss cross-SIG topics (that is not owned by a specific SIG). Is there something like this?

I posted a suggestion on the ML about this yesterday using SIG sub projects for ownership and WGs to drive standing up each architecture across other SIGs:

https://groups.google.com/g/kubevirt-dev/c/G6eCHpxJ9DU/m/PaeGjNSaAAAJ

  • A subproject per arch under SIG buildsystem to own the build aspect
    but also the infra associated with building, testing etc.
  • A working group per arch ran by the SIG buildsystem subproject team
    with the aim of handling the cross SIG collaboration required to stand
    up support for said arch
  • Additional subprojects per arch in any SIG where it's required to
    own specific logic, I could see this being useful in SIG compute for
    example to handle arch specific logic

I might be overthinking things at this point but if we do need WGs going forward then this pattern could work.

On the other hand, the original need for a more granular code ownership is still needed. In that regard, I agree with @lyarwood that we need to define subprojects in Kubevirt.

Thanks :)

@EdDev
Copy link
Member

EdDev commented Jun 7, 2024

WGs to drive standing up each architecture across other SIGs

I see, thank you for the ref.
It will be useful to evaluate this after experiencing the actual work efforts.

@dhiller
Copy link
Contributor Author

dhiller commented Jun 17, 2024

@EdDev @lyarwood I see this PR as a ground work on which the actual folks from which we require responsibilities wrt code and infra can build upon. Therefore I've kept this pretty vague by intention.

@lyarwood I don't want to take the decision from the folks inside the arch teams for S390X or ARM how they organize themselves- I think that is a decision to be taken by them; in claiming the responsibility by joining a WG and assigning subsets of code to subproject sig-buildsystem-arch-*.

What I would want to hear from folks @jschintag @cfilleke @vamsikrishna-siddu @zhlhahaha and others is how they are going to organize themselves in keeping the responsibilities that can be seen around arch work. We might then adjust the follow up PR as needed - this one I think might be left as is currently...

WDYT?

Copy link
Member

@lyarwood lyarwood left a comment

Choose a reason for hiding this comment

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

@EdDev @lyarwood I see this PR as a ground work on which the actual folks from which we require responsibilities wrt code and infra can build upon. Therefore I've kept this pretty vague by intention.

@lyarwood I don't want to take the decision from the folks inside the arch teams for S390X or ARM how they organize themselves- I think that is a decision to be taken by them; in claiming the responsibility by joining a WG and assigning subsets of code to subproject sig-buildsystem-arch-*.

ACK understood.

/lgtm

What I would want to hear from folks @jschintag @cfilleke @vamsikrishna-siddu @zhlhahaha and others is how they are going to organize themselves in keeping the responsibilities that can be seen around arch work. We might then adjust the follow up PR as needed - this one I think might be left as is currently...

WDYT?

+1

@kubevirt-bot kubevirt-bot added the lgtm Indicates that a PR is ready to be merged. label Jun 20, 2024
dhiller and others added 5 commits July 17, 2024 12:10
Create a template for working group definitions, aligned to how SIG
templates currently look.

Signed-off-by: Daniel Hiller <[email protected]>
Fix whitespace, link to membership policy instead.

Co-authored-by: aburdenthehand <[email protected]>
Signed-off-by: Daniel Hiller <[email protected]>
Co-authored-by: aburdenthehand <[email protected]>
Signed-off-by: Daniel Hiller <[email protected]>
Also add two example GitHub handles under chairs to make clear that two
are the minimum.

Signed-off-by: Daniel Hiller <[email protected]>
@dhiller
Copy link
Contributor Author

dhiller commented Jul 17, 2024

Great stuff. I have no complaints and am really happy to see this. I've suggested a couple of changes in the templates

@aburdenthehand thank you for your review, I've addressed the comments. PTAL!

@aburdenthehand
Copy link
Member

/lgtm

@kubevirt-bot kubevirt-bot added the lgtm Indicates that a PR is ready to be merged. label Jul 22, 2024
@dhiller
Copy link
Contributor Author

dhiller commented Aug 22, 2024

This PR is waiting for three weeks now.

Hey @cwilkers @davidvossel @fabiand @rmohr @vladikr 👋

Since @aburdenthehand is out for a while, is one of you able to take a quick look and approve this?

@kubevirt-bot
Copy link

Pull requests that are marked with lgtm should receive a review
from an approver within 1 week.

After that period the bot marks them with the label needs-approver-review.

/label needs-approver-review

@kubevirt-bot
Copy link

@kubevirt-bot: The label(s) needs-approver-review cannot be applied, because the repository doesn't have them.

In response to this:

Pull requests that are marked with lgtm should receive a review
from an approver within 1 week.

After that period the bot marks them with the label needs-approver-review.

/label needs-approver-review

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-sigs/prow repository.

@dhiller dhiller added the needs-approver-review Indicates that a PR requires a review from an approver. label Sep 23, 2024
@vladikr
Copy link
Member

vladikr commented Sep 23, 2024

@jean-edouard did you have a chance to go over this PR?

@jean-edouard
Copy link
Contributor

@jean-edouard did you have a chance to go over this PR?

@dhiller are WGs still something we're considering?

@dhiller
Copy link
Contributor Author

dhiller commented Sep 24, 2024

@jean-edouard did you have a chance to go over this PR?

@dhiller are WGs still something we're considering?

@jean-edouard this PR only does groundwork, i.e. laying out the structure for contributors who want to organize inside a working group, in cases where a SIG does not fit.

IMHO this is necessary so that contributors know how we think governance inside KubeVirt org works - and I believe that a defined governance process is also a requirement for the graduation of KubeVirt, see #307.

Please note that this PR does not define any WG by itself - although I did create a PR for WG arches to test out how an example WG might look like.

Copy link
Member

@EdDev EdDev left a comment

Choose a reason for hiding this comment

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

Looks great, thank you very much!

@vladikr
Copy link
Member

vladikr commented Sep 24, 2024

Thanks @dhiller !
/approve

@kubevirt-bot kubevirt-bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Sep 24, 2024
Copy link
Contributor

@jean-edouard jean-edouard left a comment

Choose a reason for hiding this comment

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

/approve
Just one nit inline.


## Goals

The primary goal of the charters is to define the scope of the WG within KubeVirt and how the WG can determine whether it has achieved their solution. A majority of the effort should be spent on these concerns.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The primary goal of the charters is to define the scope of the WG within KubeVirt and how the WG can determine whether it has achieved their solution. A majority of the effort should be spent on these concerns.
The primary goal of the charters is to define the scope of the WG within KubeVirt and how the WG can determine whether it has reached its goal(s). Most of the effort should be spent on these concerns.

@kubevirt-bot
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jean-edouard, vladikr

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

The pull request process is described here

Needs approval from an approver in each of these files:
  • OWNERS [jean-edouard,vladikr]

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

@kubevirt-bot kubevirt-bot merged commit bce90f1 into kubevirt:main Sep 24, 2024
2 checks passed
@dhiller dhiller deleted the wg-template branch September 24, 2024 13:46
@kubevirt-bot
Copy link

/remove-label needs-approver-review

@kubevirt-bot kubevirt-bot removed the needs-approver-review Indicates that a PR requires a review from an approver. label Oct 25, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates the PR's author has DCO signed all their commits. lgtm Indicates that a PR is ready to be merged. size/L
Projects
None yet
Development

Successfully merging this pull request may close these issues.