Skip to content

Commit 9e74c32

Browse files
authored
Merge pull request #6295 from liggitt/annual-reports
Annual report process cleanup
2 parents 5935682 + 7e4cddf commit 9e74c32

File tree

1 file changed

+29
-59
lines changed

1 file changed

+29
-59
lines changed

committee-steering/governance/annual-reports.md

Lines changed: 29 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Kubernetes Community Group Annual Reports
22

3-
This document outlines the bootstrap process for an annual reporting and
4-
communication structure for Special Interest Groups (SIGs), Working Groups (WGs)
5-
, User Groups (UGs), and Committees
3+
This document outlines the process for an annual reporting and
4+
communication structure for Special Interest Groups (SIGs), Working Groups (WGs),
5+
User Groups (UGs), and Committees.
66
All policy updates will be in their respective [SIG], [WG], and [UG]
77
governance docs as well as the general [governance] guidance.
88

@@ -26,56 +26,29 @@ to make this an agenda item of topic to discuss together. Chairs and Organizers
2626
ensure that reports are complete, accurate, and submitted to the Steering
2727
Committee.
2828

29-
### 2021 and on:
30-
1. Steering Committee liaison reaches out to group leads to kick off
31-
2. Chairs/Organizers will:
32-
- share with their groups (see tips below) and begin to
33-
compile the doc due April 8th - final version
34-
- use this [question template]
35-
- submit a pull request with at least the template questions against the set
36-
issue to the groups documentation in the community repo by March 8th
37-
- verify that Steering Liaison has reviewed
38-
- post a call for comments period with your groups mailing list and a complete
39-
questionnaire; you can follow your charter communication period if you have
40-
one but no less than 72 hours
41-
- if there are private matters to address with Steering before submitting the
42-
pull request, share a copy with your liaison and wait until comments are
43-
addressed before submitting.
44-
3. The March edition of the "Chairs, Tech Leads, and Organizers" meetings will
45-
be used as follow up for the community groups that have questions from/to
46-
Steering and a retrospective
47-
4. The Steering Committee liaison will work directly with groups that have
48-
follow up items and update Steering during regular monthly meetings. The liaison
49-
will also coordinate time with the Chairs (as a group). If you'd like to meet
50-
1:1 instead, please let your liaison know.
51-
We'd like to hear about the following:
52-
- goals you have for the group, your experience in the role so far -
53-
challenges, wins, things you didn’t know before but wish you did,
54-
- continue in the role or help finding a replacement if you've already asked
55-
the group,
56-
- any feedback you have for us as a body and how we can help Chairs and
57-
Organizers succeed and feel comfortable in your role.
58-
59-
### 2020:
60-
Due to playing catch up with 37 community groups, we will have a slightly
61-
modified timeline bootstrap process this year and then will follow the process
62-
outlined for 2021. Working Groups, due to their temporary nature, will be the
63-
only group to submit for 2020.
64-
65-
1. Steering Committee will assign one member as a liaison to each community
66-
group for kick off, help, or guidance needed throughout the process during the
67-
first week of July
68-
2. Working Group Organizers create one report and send it to/share it with
69-
[email protected] for review; reports should take ~30 days to
70-
complete (work with your liaison on timeline)
71-
3. Steering will schedule private meetings to follow up on anything denoted as
72-
a private matter on the report; reports are not made public until all private
73-
comments have been addressed
74-
4. Once reviewed and follow ups are completed, the liaison will ask the
75-
organizer(s) of the group to submit a pull request to that groups documentation
76-
in the community repo
77-
5. The Steering Committee liaison will work directly with groups that have
78-
follow up items and update Steering during regular monthly meetings.
29+
1. Early January (of the following year)
30+
* Steering Committee finalizes [questions] and generates draft
31+
`annual-report-YYYY.md` templates for each group in the community repo
32+
* Steering Committee liaison reaches out to group leads to kick off
33+
2. January-February
34+
* Chairs/Organizers work with their group (see tips below) to open
35+
a pull request to the group's documentation in the community repo,
36+
updating the draft to complete the questions
37+
* post a call for comments period on the PR with your group's mailing list;
38+
you can follow your charter communication period if you have one,
39+
but no less than 72 hours
40+
* verify that Steering Liaison has reviewed
41+
* merge a completed report by the end of February
42+
3. March
43+
* Steering Committee produces a project-wide annual report,
44+
summarizing and highlighting elements from the individual group reports.
45+
* The Steering Committee liaison will work directly with groups that have
46+
follow up items and update Steering during regular monthly meetings. The liaison
47+
will also coordinate time with the Chairs (as a group). If you'd like to meet
48+
1:1 instead, please let your liaison know.
49+
* The March edition of the "Chairs, Tech Leads, and Organizers" meetings will
50+
be used as follow up for the community groups that have questions from/to
51+
Steering and a retrospective
7952

8053
### Tips for Chairs and Working Group Organizers:
8154
- Work together with your groups roles and community members to complete;
@@ -85,14 +58,11 @@ owners or other community members
8558
- All questions require a response.
8659
- End users and other members of the community will read these. Err on the side
8760
of being more explicit than using our upstream shorthand or abbreviations.
88-
- If there are any private matters that you'd like to discuss as part of the
89-
questions, share the document with us at [email protected] before
90-
submitting the pull request.
91-
- The [question template] can be forked into whatever medium you wish to
61+
- The [questions] can be forked into whatever medium you wish to
9262
collaborate with your community: gdocs, hackmd, etc - it will all land back into
9363
a pull request at the end.
9464

95-
## Questions for report:
65+
## Questions for report: {#questions}
9666

9767
#### Special Interest Groups:
9868
##### Operational
@@ -155,4 +125,4 @@ https://www.apache.org/foundation/board/reporting
155125
[WG]: https://git.k8s.io/community/committee-steering/governance/wg-governance.md
156126
[UG]: https://git.k8s.io/community/committee-steering/governance/ug-governance.md
157127
[governance]: https://git.k8s.io/community/governance.md
158-
[question template]: https://docs.google.com/document/d/1HeABRzhgF9NNpM0xGKLDhhc6bRfQuulsIsb59AjyS9M/edit#
128+
[questions]: #questions

0 commit comments

Comments
 (0)