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

Ensure consistent requirements between TI lifecycle docs #268

Closed
5 of 6 tasks
marcelamelara opened this issue Feb 20, 2024 · 13 comments
Closed
5 of 6 tasks

Ensure consistent requirements between TI lifecycle docs #268

marcelamelara opened this issue Feb 20, 2024 · 13 comments
Labels
administration documentation Improvements or additions to documentation

Comments

@marcelamelara
Copy link
Contributor

marcelamelara commented Feb 20, 2024

The TI Gives + Gets currently diverge from the requirements for TI lifecycle stages (WG, Project and SIG).

There are two areas where we need to evaluate the docs for consistency and completeness:

This issue is meant to track the tasks needed to resolve any remaining inconsistencies and missing requirements:

Per the 2/20/2024 TAC meeting discussion, there's a need to revisit and document specific repo-structure requirements for TIs (e.g., charter updates, other .md files, etc).

There's also a desire to lower the barrier to entry for non-WG sandbox stage TIs and make TAC approval optional.
For instance, the TI G+Gs currently require sandbox TIs to adhere to the SSDGP and the Open Source Consumption Manifesto. These requirements only make sense for project TIs, and it's not clear if these are too steep a requirement for sandbox-level projects.

@lehors
Copy link
Contributor

lehors commented Feb 20, 2024

I think it's a healthy thing to do to review what we have and make sure the differences we have are intentional and not just merely accidental. However, we shouldn't assume that we ought to have alignment across all TIs. Some differences are intentional and ought to be kept. We do not want the TAC to be the sole point of control. Delegation of that control is key to scalability.

@marcelamelara
Copy link
Contributor Author

Totally agree. I think part of the current issue is that the TI G+Gs don't always make the distinction between different types of TIs and their specific requirements. So we have this muddled set of requirements at the moment (in that doc). My ideal outcome for this issue would be to have the lifecycle docs be the clear authoritative source for requirements, and deduplicate this information from the Gives + Gets to avoid confusion :)

@marcelamelara
Copy link
Contributor Author

marcelamelara commented Feb 20, 2024

Moving this discussion from https://github.com/ossf/tac/pull/262/files#r1491166612 here.

My summary:

  • Should Projects require TAC approval for lifecycle transitions? (SIGs currently do not)
  • How do we reconcile the need for opening a PR in this repo to submit a project's or SIG's sandbox application (which effectively amounts to needing some form of TAC approval) with the desire to make the TAC approval optional for projects and SIGs? Is this really about online vs offline TAC votes?

@steiza please let me know if I missed anything!

@lehors
Copy link
Contributor

lehors commented Feb 20, 2024

My summary:

* Should SIGs and Projects _require_ TAC approval for lifecycle transitions?

SIGs should not for sure.

* How do we reconcile the need for opening a PR in this repo to submit a project's or SIG's sandbox application (which effectively amounts to a TAC approval) with the desire to make the TAC approval optional for projects and SIGs? Is this really about online vs offline TAC votes?

For SIGs we clearly state that:

SIGs can be created and managed without formal approval from the TAC.
[...]
Because no formal approval by the TAC is required the PR can be merged by any TAC or staff member.

https://github.com/ossf/tac/blob/main/process/sig-lifecycle.md#sig-creation-or-change-of-lifecycle-stage

@marcelamelara
Copy link
Contributor Author

Yes! I went back and edited my questions afterwards to adjust for the fact that this is already clearly laid out for SIGs.

@lehors
Copy link
Contributor

lehors commented Feb 20, 2024

Something could probably be done to make that kind of information easier to find but this might take some skilled person.

@SecurityCRob
Copy link
Contributor

My summary:

* Should SIGs and Projects _require_ TAC approval for lifecycle transitions?

SIGs should not for sure.

* How do we reconcile the need for opening a PR in this repo to submit a project's or SIG's sandbox application (which effectively amounts to a TAC approval) with the desire to make the TAC approval optional for projects and SIGs? Is this really about online vs offline TAC votes?

For SIGs we clearly state that:

SIGs can be created and managed without formal approval from the TAC.
[...]
Because no formal approval by the TAC is required the PR can be merged by any TAC or staff member.

https://github.com/ossf/tac/blob/main/process/sig-lifecycle.md#sig-creation-or-change-of-lifecycle-stage

Agreed

@SecurityCRob
Copy link
Contributor

Something could probably be done to make that kind of information easier to find but this might take some skilled person.

Also agreed. We need to make this stuff better accessible. updating the landing page will help, but more ideas and suggestions are welcome.

@SecurityCRob SecurityCRob added documentation Improvements or additions to documentation administration labels Feb 23, 2024
@SecurityCRob
Copy link
Contributor

SANDBOX
#274
#282
#275
INCUBATING
#276
#277
#278
GRADUATED
#279
#280
#281

@marcelamelara
Copy link
Contributor Author

With the updated templates, we'll want to get the TI_lifecycle.md docs in sync next as well.

steiza added a commit that referenced this issue Mar 4, 2024
This is not a full fix for #268, but this particular part is
inconsistent with our other process docs.

Signed-off-by: Zach Steindler <[email protected]>
@SecurityCRob
Copy link
Contributor

Do we think that the requirements are now aligned between the project, WG, ans SIG documents? What needs adjusted for the Gives and Gets and who is interested in fleshing out "SIF" (if we still desire to have that category?)?

@marcelamelara
Copy link
Contributor Author

marcelamelara commented Mar 19, 2024

Thanks for ping on this. I think once #295, #296 and #297 are merged, we'll be there.

@marcelamelara
Copy link
Contributor Author

I think we can close this now. One piece we have left to resolve is the discussion from #85, we can focus the conversation in that issue.

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
Projects
None yet
Development

No branches or pull requests

3 participants