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

Update SIG processes and ensure consistency & alignment with WG & project processes #161

Closed
SecurityCRob opened this issue May 13, 2023 · 15 comments
Labels
administration documentation Improvements or additions to documentation enhancement New feature or request For Review help wanted Extra attention is needed

Comments

@SecurityCRob
Copy link
Contributor

TAC has good documentation around new project creation & lifecycle & working group lifecycle- https://github.com/ossf/tac/blob/main/process/project-lifecycle.md , https://github.com/ossf/tac/blob/main/process/working-group-lifecycle.md

Comparability, SIG documentation is lacking - https://github.com/ossf/tac/blob/main/process/sig-lifecycle.md

No documentation exists today for Special Interest Funds (SIFs) or Affiliated Projects (APs)

The TAC should ensure clearly documented processes exist that describe:

  • Special interest Groups(SIG) have an adoption and lifecycle process that describes stages from beginning to possible eventual retirement of these groups
  • gives/gets for each level of the SIG lifecycle should be
  • Document who evaluates and votes upon creation/retirement/modification of these groups - TAC, WG, other?
  • SIFs and APs should be clearly documented for proposal, adoption, and lifecycle processes
  • documentation/language updated in WG/SIG charters, readme's, & security.md's that accurately describes desired processes for membership criteria, membership ladders/rewarding contributions, documentation how group votes are conducted and eligibility requirements
@SecurityCRob SecurityCRob added documentation Improvements or additions to documentation enhancement New feature or request help wanted Extra attention is needed administration For Review labels May 13, 2023
@lehors
Copy link
Contributor

lehors commented May 16, 2023

I agree about the SIFs and APs (if that's even really how they are called, I've seen various instances of Affiliated vs Associated Projects for instance.)
Regarding SIGs, although what we have is indeed very minimal I must admit not to know what is actually lacking.

The reality is that the majority of the projects and WGs lifecycle isn't used so I'm hesitant to create more stuff that may not be used either. From that point of view, I think it's better to add stuff in response to actual needs. What are the needs that are not met today?

@SecurityCRob
Copy link
Contributor Author

The guidance does not need to be heavy, but should inform folks any required steps or things to care about so they can run with it and go do great things.

@steiza
Copy link
Member

steiza commented May 16, 2023

We might need to update https://github.com/ossf/tac/blob/main/organizational-structure-overview.md as part of this work.

Currently that document describes SIGs as reporting to a WG, not the TAC (although even if we keep that structure, we can of course provide lightweight guidance on adoption criteria and lifecycle process).

@AevaOnline
Copy link
Contributor

The existing documentation does not cover SIFs or APs, as my previous attempts to quantify those were post-hoc and encountered organizational challenges.

On the topic of WGs and SIGs, refining the process from last year, and normalizing it across WGs and SIGs, seems entirely appropriate to me. Are there specific areas of friction or fragmentation that folks would like to address?

@hythloda
Copy link
Member

hythloda commented May 16, 2023

This was brought up in the TAC with @torgo @ware @bobcallaway @steiza @hythloda volunteering to help
Do want a zoom meeting to get this started? Or async?

@ware
Copy link
Contributor

ware commented May 16, 2023

I'll defer to others. I can do either.

@lehors
Copy link
Contributor

lehors commented May 24, 2023

We might need to update https://github.com/ossf/tac/blob/main/organizational-structure-overview.md as part of this work.

Currently that document describes SIGs as reporting to a WG, not the TAC (although even if we keep that structure, we can of course provide lightweight guidance on adoption criteria and lifecycle process).

Are you saying we should allow SIGs to be reporting to the TAC or all SIGs should report to the TAC?
I think the former is fine. This would be consistent with allowing projects to report directly to the TAC. I don't think we want all SIGs to report to the TAC though. That'd be a major change from how things have been done and I'm not sure what the gain would be.
What I think we might want to do is define the process WGs need to follow to create SIGs so that it's done consistently throughout the org.

@steiza
Copy link
Member

steiza commented Jun 6, 2023

This will not be an easy issue to solve, but at the same time we have to start somewhere. To that end I have started OpenSSF Workstream Taxonomy (EDIT: updated link for wider access) to cover scope, questions, and exit criteria, as well as existing hierarchy and references. Let's start the process by asynchronously collaborating there, and then use that to determine next steps.

@hythloda
Copy link
Member

hythloda commented Jun 8, 2023

This will not be an easy issue to solve, but at the same time we have to start somewhere. To that end I have started OpenSSF Workstream Taxonomy (EDIT: updated link for wider access) to cover scope, questions, and exit criteria, as well as existing hierarchy and references. Let's start the process by asynchronously collaborating there, and then use that to determine next steps.

This is a great start! @torgo @ware @bobcallaway did you get a chance to see it?

@hythloda
Copy link
Member

hythloda commented Jun 8, 2023

This is something that really needs some thoughts/ideas/comments. Just today I noticed that we have Alpha-Omega defined twice in our Intro:
Screenshot 2023-06-08 at 4 16 17 PM

@SecurityCRob
Copy link
Contributor Author

SecurityCRob commented Jun 9, 2023 via email

steiza added a commit that referenced this issue Jul 7, 2023
Update SIG lifecycle doc based on questions raised and commuinity
discussion

Signed-off-by: Zach Steindler <steiza@github.com>
This was referenced Jul 7, 2023
@steiza
Copy link
Member

steiza commented Jul 10, 2023

Today I learned about OpenSSF Associated Projects doc, which might be helpful after we complete the SIG part of this workstream.

@david-a-wheeler
Copy link
Contributor

My understanding was that "project" was to be used for efforts that focused on code, while SIG was to be used for efforts that didn't focus on code. E.g., the MFA distribution effort would be considered a SIG. I don't think everything should have to report directly to the TAC; the TAC is busy enough & we don't want all things to bottleneck through a few overworked people. Most SIGs are part of WGs; we need to make sure the WGs are monitoring their SIGs, and then the TAC doesn't have to do everything.

If I'm mistaken, or a change in direction is desired, that's okay too, making it clear is the key.

@lehors
Copy link
Contributor

lehors commented Jul 10, 2023

Is anyone saying all SIGs should report to the TAC? I think we should make it possible to have SIGs under the TAC but I expect the majority to still report to a WG.

steiza added a commit that referenced this issue Aug 4, 2023
Update SIG lifecycle doc based on questions raised and commuinity
discussion

Signed-off-by: Zach Steindler <steiza@github.com>
steiza added a commit that referenced this issue Sep 8, 2023
For #161

Update SIG lifecycle doc based on questions raised and community discussion

Signed-off-by: Zach Steindler <steiza@github.com>
Co-authored-by: Joshua Lock <jlock@vmware.com>
Co-authored-by: Dustin Ingram <di@users.noreply.github.com>
@SecurityCRob
Copy link
Contributor Author

changes have been merged to align all TI-types with consistent stages: Sandbox, Incubation, Graduation, and Archive. "Gives and Gets" are being discussed as part of the Ops Model work, and will added into TI documentation once agreed upon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
administration documentation Improvements or additions to documentation enhancement New feature or request For Review help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

10 participants