Skip to content

Commit 15a1ece

Browse files
steizajoshuagldi
authored
Update SIG lifecycle doc (ossf#182)
For ossf#161 Update SIG lifecycle doc based on questions raised and community discussion Signed-off-by: Zach Steindler <[email protected]> Co-authored-by: Joshua Lock <[email protected]> Co-authored-by: Dustin Ingram <[email protected]>
1 parent 3b18e35 commit 15a1ece

File tree

2 files changed

+35
-8
lines changed

2 files changed

+35
-8
lines changed

organizational-structure-overview.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The OpenSSF is comprised of instances of the following categories of official gr
2020
- A WG may also launch Special Interest Groups (SIG) to perform specific tasks other than creating software.
2121
- WGs often include some open source code, or use licensed software, in fulfilment of their Charter.
2222
- A **Project** is a Technical Initiative focused on the development and ongoing support of open source licensed software (source code) and its supporting artifacts (technical documentation, etc.).
23-
- **Special Interest Groups** (SIG) are under the direct governance of their reporting WGs and are bound to achieving a very specific goal. These groups may be terminated upon completion of their designating tasking, continued for larger and ongoing efforts, or otherwise subject to the governance, structure, and termination policies of the WG they are under. The creation of a SIG must dictate the focus, intent, goals, and deliverable(s) as appropriate.
23+
- **Special Interest Groups** (SIG) are bound to achieving a very specific goal. These groups may be terminated upon completion of their designating tasking or continued for larger and ongoing efforts. The creation of a SIG must dictate the focus, intent, goals, and deliverable(s) as appropriate. SIGs may report to a WG or directly to the TAC.
2424
- A **Technical Deliverable** is any technical content produced by a Technical Initiative, such as open source licensed software, a specification, or a technical guide.
2525
- Each **Project** shall have at least one Technical Deliverable including open source licensed software; this is what defines a Project as distinct from other Technical Initiatives such as SIGs.
2626
- A **Service** is a publicly-run instance of software as a service, and is another form of Technical Deliverable distinct from the release of open source licensed software. This may be an operational output of a Technical Initiative in which software is either built or acquired to support or automate OSSF transactions.
@@ -31,7 +31,7 @@ The following table describes the main types of groups and their characteristics
3131
|------------|-------------------|---------------|------------------------|---------------
3232
| Working Group (WG) | unbounded | not software | to the TAC | normative
3333
| Project | unbounded | software | either TAC or WG | normative
34-
| Special Interest Group (WG) | bounded | not software | to a WG | normative
34+
| Special Interest Group (WG) | bounded | not software | either TAC or WG | normative
3535

3636

3737
### TODO

process/sig-lifecycle.md

+33-6
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,40 @@
11
# Special Interest Group (SIG) Life Cycle
22

3-
Special Interest Groups are under the direct governance of a Working Group (WG) which can create and close them as necessary and appropriate. SIGs are expected to have a very specific goals and objectives at the time of their creation which may or may not define if they are terminable and is entirely dependent on the nature of the SIG.
3+
Special Interest Groups are bound to achieving a very specific goal. These groups may be terminated upon completion of their designating tasking or continued for larger and ongoing efforts. The creation of a SIG must dictate the focus, intent, goals, and deliverable(s) as appropriate. SIGs may report to a WG or directly to the TAC as their governing body.
44

5-
The lifecycle of SIGs is therefore minimal and as follows.
5+
It is expected that the primary output of a SIG is not software. If the primary output is software, the work should be organized as a [project](./project-lifecycle.md).
66

7-
## Active
7+
SIG process should be minimal, however we do need some process to at least ensure we have an accurate list of all the active SIGs in the OpenSSF. This document uses "must" to describe what items are required, "should" to suggest items that should be strongly considered (but not required), and "may" for suggested guidance.
88

9-
* The SIG is actively pursuing its goal.
9+
The SIG life cycle begins with interested contributors deciding to undertake this process, at which time the SIG is `Tentative`. A SIG becomes `Active` when a governing body agrees to take it on, at which point the SIG goes about achieving its goals and deliverables. Once that work is completed, or if the effort stalls out, the SIG becomes `End-of-Life` and some administrative cleanup will be done. The details for each phase follow.
1010

11-
## Inactive
11+
## To become `Tentative`:
1212

13-
* The SIG is no longer active, either it has completed its mission or the mission was abandoned. At which state, the WG the SIG is under will determine a termination status and record it within the corresponding repository.
13+
* This is the default state of a new SIG that is not yet active
14+
15+
## To become `Active`:
16+
17+
* A governing body must agree to govern the SIG
18+
* The governing body may have its membership vote, with notice given at the meeting prior to the vote
19+
20+
## Once `Active`:
21+
22+
* The governing body must list information about the SIG on its README, including current state, chairs, and a statement of focus, intent, goals, and/or deliverables
23+
* SIGs may have regular meetings separate from their governing body, if so:
24+
* They should appear on the OpenSSF calendar
25+
* They should have a document with upcoming agendas and notes from past meetings
26+
27+
## To become `End-of-Life`:
28+
29+
* The chairs of a SIG can decide to conclude their work, in which case they must notify their governing body
30+
* The chairs of the governing body must periodically review their active SIGs and determine if any should end
31+
* This review should happen at least annually
32+
* The chairs of the governing body may have its membership vote, with notice given at the meeting prior to the vote
33+
34+
## Once `End-of-Life`
35+
36+
* The governing body must update their README to reflect that the SIG has ended
37+
* They should list the SIG as end-of-life instead of removing it completely
38+
* If a repository exists, it should be marked read-only
39+
* If meetings are on the OpenSSF calendar, they should be removed
40+
* Any other administrative items (mailing lists, docs) should similarly be put to closure as needed

0 commit comments

Comments
 (0)