|
| 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