Skip to content

Commit 4b682b6

Browse files
committed
Copy document authored by @jdumars into a PR. (Thanks Jaice)
1 parent 22653fb commit 4b682b6

File tree

1 file changed

+87
-0
lines changed

1 file changed

+87
-0
lines changed
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# Kubernetes Working Group Formation Process - Proposal
2+
3+
Draft 1.0 // Jaice Singer DuMars // June, 2018
4+
5+
## Process Overview and Motivations
6+
As opposed to “Birds of a Feather” or discussion groups, Working Groups provide a more formal avenue for disparate
7+
groups to intellectually collaborate around a common problem, craft a balanced position, and disband. Because they
8+
represent the interests of multiple special interest groups, they are a vehicle for consensus building, not
9+
construction. By design, the code under discussion resides in either multiple parts of the project, or is in the
10+
process of being extracted to an external repository.
11+
12+
Because a Working Group is an acknowledged part of the Kubernetes governance model, a process is necessary for
13+
formation and disbanding, as well as guidance on what authority is vested in the group by the steering committee.
14+
15+
## Goals of the process
16+
17+
- An easy-to-navigate process for those wishing to establish and eventually disband a new Working Group
18+
- Simple guidance and differentiation on where a Working Group makes sense, and does not
19+
- Clear understanding that no authority is vested in a Working Group
20+
- Ensure all future Working Groups conform with this process
21+
22+
## Non-goals of the process
23+
24+
- Documenting other governance bodies such as sub-projects or SIGs
25+
- Changing the status of existing Working Groups/SIGs/Sub-projects
26+
27+
## Is it a Working Group? Yes, if...
28+
- It does not own any code
29+
- It has a clear goal measured through a specific deliverable or deliverables
30+
- It is temporary in nature and will be disbanded after reaching its stated goal(s)
31+
- It requires input from more than one SIG/sub-project to come up with an adequately-vetted deliverable with reasonable
32+
stakeholder consensus
33+
- It is formulating vendor/implementation-agnostic deliverables
34+
35+
## Creation Process Description
36+
37+
Working Group formation is less tightly-controlled than SIG formation since they:
38+
39+
- Do not own code
40+
- Have a clear entry and exit criteria
41+
- Do not have any organizational authority, only influence
42+
43+
Therefore, Working Group formation begins with the organizers asking themselves some important questions that
44+
should eventually be reflected in a pull request on sigs.yaml:
45+
46+
1. What is the exact problem this group is trying to solve?
47+
1. What is the artifact that this group will deliver, and to whom?
48+
1. How does the group know when the problem solving process is completed, and it is time for the Working Group to
49+
dissolve?
50+
1. Who are all of the stakeholders involved in this problem this group is trying to solve (SIGs, steering committee,
51+
other Working Groups)?
52+
1. What are the meeting mechanics (frequency, duration, roles)?
53+
1. Does the goal of the Working Group represent the needs of the project as a whole, or is it focused on the interests
54+
of a narrow set of contributors or companies?
55+
1. Who will chair the group, and ensure it continues to meet these requirements?
56+
1. Is diversity well-represented in the Working Group?
57+
58+
Once the above questions have been answered, the pull request against sigs.yaml can be created. Once the generator
59+
is run, this will in turn create the OWNERS_ALIASES file, readme files, and the main SIGs list. The minimum
60+
requirements for that are:
61+
62+
- name
63+
- directory
64+
- mission statement
65+
- chair information
66+
- meeting information
67+
- contact methods
68+
69+
The pull request should be labeled with the SIG stakeholders and committee/steering. And since GitHub notifications
70+
are not a reliable means to contact people, an email should be sent to the mailing lists for the stakeholder SIGs,
71+
and the steering committee with a link to the PR. A member of the community admin team will place a /hold on it
72+
until it has an LGTM from at least one chair from each of the stakeholder SIGs, and a simple majority of the steering
73+
committee.
74+
75+
Once merged, the Working Group is officially chartered until it either completes its stated goal, or disbands
76+
voluntarily due to new facts, member attrition, or other issues. Working groups should strive to make regular
77+
reports to stakeholder SIGs in order to ensure the mission is still aligned with the current state.
78+
79+
Deliverables (documents, diagrams) for the group should be stored in the directory created for the Working Group.
80+
If the deliverable is a KEP, it would be helpful to link it in the closed formation/charter PR for future reference.
81+
82+
References
83+
84+
- [1] https://github.com/kubernetes/community/pull/1994
85+
- [2] https://groups.google.com/a/kubernetes.io/d/msg/steering/zEY93Swa_Ss/C0ziwjkGCQAJ
86+
87+

0 commit comments

Comments
 (0)