Skip to content

Commit 50b57c5

Browse files
committed
SIG governance: Overhaul subproject requirements
Brings subproject creation and requirements in line with what is actually being done today by the majority of contributors.
1 parent 2f4aafc commit 50b57c5

File tree

1 file changed

+14
-50
lines changed

1 file changed

+14
-50
lines changed

committee-steering/governance/sig-governance.md

Lines changed: 14 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ Additional information on the Tech Lead role can be found in
138138

139139
#### Subproject Owner
140140

141-
- Number: 2-3
141+
- Number: 2+
142142
- Scoped to a subproject defined in [sigs.yaml]
143143
- Seed leads and contributors established at subproject founding
144144
- *SHOULD* be an escalation point for technical discussions and decisions in
@@ -201,64 +201,27 @@ Other roles...
201201

202202
### Subproject Creation
203203

204-
#### Option 1: by SIG Technical Leads
205-
206-
Subprojects may be created by [KEP] proposal and accepted by [lazy-consensus]
207-
with fallback on majority vote of SIG Technical Leads. The result *SHOULD* be
208-
supported by the majority of SIG Leads.
209-
- KEP *MUST* establish subproject owners.
204+
Subprojects may be created with a simple majority vote of SIG Technical Leads.
210205
- [sigs.yaml] *MUST* be updated to include subproject information and [OWNERS]
211206
files with subproject owners.
212207
- Where subprojects processes differ from the SIG governance, they must
213208
document how. e.g. if subprojects release separately - they must document
214209
how release and planning is performed
215210

216-
#### Option 2: by Federation of Subprojects
217-
218-
Subprojects may create repos under *github.com/kubernetes-sigs* through
219-
[lazy-consensus] of subproject owners.
220-
221-
Subprojects may be created by [KEP] proposal and accepted by [lazy-consensus]
222-
with fallback on majority vote of subproject owners in the SIG. The result
223-
*SHOULD* be supported by the majority of Leads.
224-
- KEP *MUST* establish subproject owners.
225-
- [sigs.yaml] *MUST* be updated to include subproject information and [OWNERS]
226-
files with subproject owners.
227-
- Where subprojects processes differ from the SIG governance, they must
228-
document how. e.g. if subprojects release separately - they must document
229-
how release and planning is performed
230-
231-
### Subproject Release Process Requirements
232-
233-
- Subprojects must define how releases are performed and milestones are set.
234-
235-
**Example:**
236-
237-
> - Release milestones
238-
> - Follows the kubernetes/kubernetes release milestones and schedule
239-
> - Priorities for upcoming release are discussed during the SIG meeting
240-
> following the preceding release and shared through a PR. Priorities are
241-
> finalized before feature freeze.
242-
> - Code and artifacts are published as part of the kubernetes/kubernetes release
243-
244-
245-
### Subproject Technical processes
211+
### Subproject Requirements
246212

247-
Subprojects of the SIG *MUST* use the following processes unless explicitly
248-
following alternatives they have defined.
213+
Subprojects broadly fall into two categories, those that are directly part
214+
of [Kubernetes] core and those that are tool, driver, or other component that
215+
do not adhere to the Kubernetes release cycle.
249216

250-
- Proposing and making decisions
251-
- Proposals sent as [KEP] PRs and published to googlegroup as announcement
252-
- Follow [KEP] decision making process
217+
**Kubernetes Core Subprojects**
218+
- *MUST* use the [KEP] process for introducing new features and decision
219+
making.
220+
- *MUST* Adhere to release test health requirements.
253221

254-
- Test health
255-
- Canonical health of code published to [dashboard]
256-
- Consistently broken tests automatically send an alert to their google group.
257-
- SIG contributors are responsible for responding to broken tests alert. PRs
258-
that break tests should be rolled back if not fixed within 24 hours
259-
(business hours).
260-
- Test dashboard checked and reviewed at start of each SIG meeting. Owners
261-
assigned for any broken tests and followed up during the next SIG meeting.
222+
**Non Kubernetes Core Subprojects**
223+
- *SHOULD* define how releases are performed.
224+
- *SHOULD* setup and monitor test health.
262225

263226
Issues impacting multiple subprojects in the SIG should be resolved by the
264227
SIG's Tech Leads or a federation of Subproject Owners.
@@ -271,6 +234,7 @@ otherwise fulfill its Organizational Management responsibilities
271234
- after 3 or more months it *SHOULD* be retired
272235
- after 6 or more months it *MUST* be retired
273236

237+
[Kubernetes]: https://github.com/kubernetes/kubernetes
274238
[KEPs]: https://github.com/kubernetes/enhancements
275239
[forums provided]: /communication/README.md
276240
[lazy-consensus]: http://en.osswiki.info/concepts/lazy_consensus

0 commit comments

Comments
 (0)