Merge pull request #6295 from liggitt/annual-reports

Annual report process cleanup
This commit is contained in:
Kubernetes Prow Robot 2021-12-15 07:36:18 -08:00 committed by GitHub
commit 9e74c32ab2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 59 deletions

View File

@ -1,8 +1,8 @@
# Kubernetes Community Group Annual Reports # Kubernetes Community Group Annual Reports
This document outlines the bootstrap process for an annual reporting and This document outlines the process for an annual reporting and
communication structure for Special Interest Groups (SIGs), Working Groups (WGs) communication structure for Special Interest Groups (SIGs), Working Groups (WGs),
, User Groups (UGs), and Committees User Groups (UGs), and Committees.
All policy updates will be in their respective [SIG], [WG], and [UG] All policy updates will be in their respective [SIG], [WG], and [UG]
governance docs as well as the general [governance] guidance. governance docs as well as the general [governance] guidance.
@ -26,56 +26,29 @@ to make this an agenda item of topic to discuss together. Chairs and Organizers
ensure that reports are complete, accurate, and submitted to the Steering ensure that reports are complete, accurate, and submitted to the Steering
Committee. Committee.
### 2021 and on: 1. Early January (of the following year)
1. Steering Committee liaison reaches out to group leads to kick off * Steering Committee finalizes [questions] and generates draft
2. Chairs/Organizers will: `annual-report-YYYY.md` templates for each group in the community repo
- share with their groups (see tips below) and begin to * Steering Committee liaison reaches out to group leads to kick off
compile the doc due April 8th - final version 2. January-February
- use this [question template] * Chairs/Organizers work with their group (see tips below) to open
- submit a pull request with at least the template questions against the set a pull request to the group's documentation in the community repo,
issue to the groups documentation in the community repo by March 8th updating the draft to complete the questions
- verify that Steering Liaison has reviewed * post a call for comments period on the PR with your group's mailing list;
- post a call for comments period with your groups mailing list and a complete you can follow your charter communication period if you have one,
questionnaire; you can follow your charter communication period if you have but no less than 72 hours
one but no less than 72 hours * verify that Steering Liaison has reviewed
- if there are private matters to address with Steering before submitting the * merge a completed report by the end of February
pull request, share a copy with your liaison and wait until comments are 3. March
addressed before submitting. * Steering Committee produces a project-wide annual report,
3. The March edition of the "Chairs, Tech Leads, and Organizers" meetings will summarizing and highlighting elements from the individual group reports.
be used as follow up for the community groups that have questions from/to * The Steering Committee liaison will work directly with groups that have
Steering and a retrospective follow up items and update Steering during regular monthly meetings. The liaison
4. The Steering Committee liaison will work directly with groups that have will also coordinate time with the Chairs (as a group). If you'd like to meet
follow up items and update Steering during regular monthly meetings. The liaison 1:1 instead, please let your liaison know.
will also coordinate time with the Chairs (as a group). If you'd like to meet * The March edition of the "Chairs, Tech Leads, and Organizers" meetings will
1:1 instead, please let your liaison know. be used as follow up for the community groups that have questions from/to
We'd like to hear about the following: Steering and a retrospective
- goals you have for the group, your experience in the role so far -
challenges, wins, things you didnt know before but wish you did,
- continue in the role or help finding a replacement if you've already asked
the group,
- any feedback you have for us as a body and how we can help Chairs and
Organizers succeed and feel comfortable in your role.
### 2020:
Due to playing catch up with 37 community groups, we will have a slightly
modified timeline bootstrap process this year and then will follow the process
outlined for 2021. Working Groups, due to their temporary nature, will be the
only group to submit for 2020.
1. Steering Committee will assign one member as a liaison to each community
group for kick off, help, or guidance needed throughout the process during the
first week of July
2. Working Group Organizers create one report and send it to/share it with
steering-private@kubernetes.io for review; reports should take ~30 days to
complete (work with your liaison on timeline)
3. Steering will schedule private meetings to follow up on anything denoted as
a private matter on the report; reports are not made public until all private
comments have been addressed
4. Once reviewed and follow ups are completed, the liaison will ask the
organizer(s) of the group to submit a pull request to that groups documentation
in the community repo
5. The Steering Committee liaison will work directly with groups that have
follow up items and update Steering during regular monthly meetings.
### Tips for Chairs and Working Group Organizers: ### Tips for Chairs and Working Group Organizers:
- Work together with your groups roles and community members to complete; - Work together with your groups roles and community members to complete;
@ -85,14 +58,11 @@ owners or other community members
- All questions require a response. - All questions require a response.
- End users and other members of the community will read these. Err on the side - End users and other members of the community will read these. Err on the side
of being more explicit than using our upstream shorthand or abbreviations. of being more explicit than using our upstream shorthand or abbreviations.
- If there are any private matters that you'd like to discuss as part of the - The [questions] can be forked into whatever medium you wish to
questions, share the document with us at steering-private@kubernetes.io before
submitting the pull request.
- The [question template] can be forked into whatever medium you wish to
collaborate with your community: gdocs, hackmd, etc - it will all land back into collaborate with your community: gdocs, hackmd, etc - it will all land back into
a pull request at the end. a pull request at the end.
## Questions for report: ## Questions for report: {#questions}
#### Special Interest Groups: #### Special Interest Groups:
##### Operational ##### Operational
@ -155,4 +125,4 @@ https://www.apache.org/foundation/board/reporting
[WG]: https://git.k8s.io/community/committee-steering/governance/wg-governance.md [WG]: https://git.k8s.io/community/committee-steering/governance/wg-governance.md
[UG]: https://git.k8s.io/community/committee-steering/governance/ug-governance.md [UG]: https://git.k8s.io/community/committee-steering/governance/ug-governance.md
[governance]: https://git.k8s.io/community/governance.md [governance]: https://git.k8s.io/community/governance.md
[question template]: https://docs.google.com/document/d/1HeABRzhgF9NNpM0xGKLDhhc6bRfQuulsIsb59AjyS9M/edit# [questions]: #questions