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

Change WGs to always be part of a TAG #868

Closed
wants to merge 5 commits into from
Closed

Change WGs to always be part of a TAG #868

wants to merge 5 commits into from

Conversation

RichiH
Copy link
Contributor

@RichiH RichiH commented Jul 5, 2022

No description provided.

@RichiH
Copy link
Contributor Author

RichiH commented Jul 5, 2022

This needs review/discussion, in particular on the proposed structure of listing WGs.

Copy link
Contributor

@TheFoxAtWork TheFoxAtWork left a comment

Choose a reason for hiding this comment

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

LGTM overall, some recommendations to add clarifying structure upon closure and other areas.

workinggroups/README.md Outdated Show resolved Hide resolved
workinggroups/README.md Outdated Show resolved Hide resolved
workinggroups/README.md Outdated Show resolved Hide resolved
Co-authored-by: Emily Fox <[email protected]>

Signed-off-by: Richard Hartmann <[email protected]>
Co-authored-by: Emily Fox <[email protected]>

Signed-off-by: Richard Hartmann <[email protected]>
Co-authored-by: Emily Fox <[email protected]>

Signed-off-by: Richard Hartmann <[email protected]>
workinggroups/README.md Outdated Show resolved Hide resolved
Signed-off-by: Richard Hartmann <[email protected]>

## Process
WGs must be created under the umbrella of a [CNCF Technical Advisory Group](https://github.com/cncf/toc/tree/main/tags) (TAG), and sponsored by a CNCF TOC member. In case of disagreement within TOC, a supermajority vote may be called
Copy link
Member

Choose a reason for hiding this comment

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

Can a WG be created under the umbrella of multiple TAGs?

Copy link
Contributor

Choose a reason for hiding this comment

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

@nikhita I don't see why not, i also don't believe we should prevent a TAG's WG from being joint with another foundation. However there must be a very clearly defined governance of which entity is the "home" for the WG to resolve issues as well as define CoCC and other governance, license, and process escalation related items.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think in the past we have addressed the overlaps but identifying "Related Work Areas" and "Other groups that the WG interacts with". There will always be overlap, I believe it should be fine as long as the community has clarity as to what that is.

WGs must be created under the umbrella of a [CNCF Technical Advisory Group](https://github.com/cncf/toc/tree/main/tags) (TAG), and sponsored by a CNCF TOC member. In case of disagreement within TOC, a supermajority vote may be called

WGs can be shut down
* when the working group and TAG, with concurrence of the TOC sponsor, determines that they have reached their stated goals, or
Copy link
Member

Choose a reason for hiding this comment

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

If a WG has multiple umbrella TAGs, would consensus mean consensus among all the umbrella TAGs?

Would this consensus apply to both creation and disbandment?

Choose a reason for hiding this comment

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

Do you have a WG in mind whose scope needs to span multiple TAGs? Each TAG's scope seems quite broad.

Copy link
Member

Choose a reason for hiding this comment

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

Do you have a WG in mind whose scope needs to span multiple TAGs?

I didn't have a specific WG in mind...I was thinking mostly in terms of a WG needing to collaborate with other TAGs. @TheFoxAtWork and @raravena80 captured it well here - #868 (comment) :)


You will also have to present to the CNCF TOC and wider community before your WG proposal will be voted upon by the TOC and community. You can request a presentation by filing an issue here: https://github.com/cncf/toc/issues
If you would like to submit a WG proposal, please get in contact with suitable umbrella TAGs. The TAG will follow their existing working group processes or engage with their TOC liasons to create the WG should no process exist.
Copy link
Member

@nikhita nikhita Jul 11, 2022

Choose a reason for hiding this comment

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

How would the relationship between a WG and the umbrella TAG(s) look like after WG creation but before WG disbandment?

How do the umbrella TAG(s) and the TOC sponsor ensure that the WG's mission is still aligned with its current state?
Suggestion - can we have WG representative(s) provide updates to their umbrella TAG(s) with some regularity?

Choose a reason for hiding this comment

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

I like the suggestion on the update.


* Umbrella TAG & TOC liason
Copy link
Member

Choose a reason for hiding this comment

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

nit: some places call this TOC liason and some call this TOC sponsor

Comment on lines +30 to +31
* TAG 123
* WG abc
Copy link
Member

Choose a reason for hiding this comment

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

This needs review/discussion, in particular on the proposed structure of listing WGs.

In case it's helpful, here's how Kubernetes lists down the Working Group to Stackholder SIGs mapping (especially given that one WG can map to more than one SIG) - https://github.com/kubernetes/community/blob/master/sig-list.md#working-groups

Copy link
Contributor

@halcyondude halcyondude Aug 18, 2022

Choose a reason for hiding this comment

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

I really like listing stakeholders explicitly, both for its implication, "there are likely multiple stakeholder SIG's" and because it makes clear how the WG views its scope. Were we using full RACI one might suggest that were we to adopt this, TAG co-chairs should be included on PRs as a RACI "I" (informed).

@dims
Copy link
Member

dims commented Aug 5, 2022

@RichiH could we please incorporate all the feedback so far and switch from Draft? thanks!

@raravena80
Copy link
Contributor

Discussed in the 08/16/2022 TOC meeting:

  • It would be great to have something like K8s SIGs for the CNCF https://github.com/kubernetes/community/blob/master/sigs.yaml
  • It would also be good to clarify either if the TOC needs to approve WGs in the TAG or the TAG has autonomy to create the WGs. Or if there are some cases where the TOC would need to review the approval.

@halcyondude
Copy link
Contributor

halcyondude commented Aug 17, 2022

It would also be good to clarify either if the TOC needs to approve WGs in the TAG or the TAG has autonomy to create the WGs. Or if there are some cases where the TOC would need to review the approval.

I had previously read what's below to imply that there were 2 classes/levels of WG. CNCF Working Groups ("TOC level"), and TAG created WG's.

TOC Working Groups

https://github.com/cncf/toc/tree/main/workinggroups

Working Groups can be formed at any time but must be sponsored by a TOC member and voted with a super majority vote by the CNCF TOC. The TOC can also shut down a working group with a super majority vote.

TAG Working Groups

https://github.com/cncf/toc/blob/main/tags/cncf-tags.md#responsibilities--empowerment-of-tags

TAGs may choose to spawn focused and time-limited working groups to achieve some of their responsibilities (for example, to produce a specific educational white paper, or portfolio gap analysis report). Working groups should have a clearly documented charter, timeline (typically a few quarters at most), and set of deliverables. Once the timeline has elapsed, or the deliverables delivered, the working group dissolves, or is explicitly re-chartered.


  • Are there actually 2 types of WG (or were there ever)?
  • Is the intent to have 1 type moving forward?

@dims
Copy link
Member

dims commented Aug 25, 2022

We are trying to see which groups are still active here - #911

@nikhita
Copy link
Member

nikhita commented Oct 10, 2022

From #868 (comment):

It would be great to have something like K8s SIGs for the CNCF https://github.com/kubernetes/community/blob/master/sigs.yaml

I have created #938

@nikhita
Copy link
Member

nikhita commented Aug 30, 2023

@RichiH do you have bandwidth to drive this to completion?

nikhita added a commit to nikhita/toc that referenced this pull request Aug 30, 2023
The whole process needs to be revamped as part of cncf#1158.
There was some work that was started as part of cncf#868,
but the PR has languished.

This PR keeps the existing process and defines a lightweight process for
creation of new WGs in a TAG. This mirrors the process we follow today.

Signed-off-by: Nikhita Raghunath <[email protected]>
nikhita added a commit to nikhita/toc that referenced this pull request Aug 31, 2023
The whole process needs to be revamped as part of cncf#1158.
There was some work that was started as part of cncf#868,
but the PR has languished.

This PR keeps the existing process and defines a lightweight process for
creation of new WGs in a TAG. This mirrors the process we follow today.

Signed-off-by: Nikhita Raghunath <[email protected]>
@TheFoxAtWork
Copy link
Contributor

Closing this PR as completed by #1159

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

8 participants