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
This document outlines the bootstrap process for an annual reporting and
communication structure for Special Interest Groups (SIGs), Working Groups (WGs)
, User Groups (UGs), and Committees
This document outlines the process for an annual reporting and
communication structure for Special Interest Groups (SIGs), Working Groups (WGs),
User Groups (UGs), and Committees.
All policy updates will be in their respective [SIG], [WG], and [UG]
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
Committee.
### 2021 and on:
1. Steering Committee liaison reaches out to group leads to kick off
2. Chairs/Organizers will:
- share with their groups (see tips below) and begin to
compile the doc due April 8th - final version
- use this [question template]
- submit a pull request with at least the template questions against the set
issue to the groups documentation in the community repo by March 8th
- verify that Steering Liaison has reviewed
- post a call for comments period with your groups mailing list and a complete
questionnaire; you can follow your charter communication period if you have
one but no less than 72 hours
- if there are private matters to address with Steering before submitting the
pull request, share a copy with your liaison and wait until comments are
addressed before submitting.
3. The March edition of the "Chairs, Tech Leads, and Organizers" meetings will
be used as follow up for the community groups that have questions from/to
Steering and a retrospective
4. The Steering Committee liaison will work directly with groups that have
follow up items and update Steering during regular monthly meetings. The liaison
will also coordinate time with the Chairs (as a group). If you'd like to meet
1:1 instead, please let your liaison know.
We'd like to hear about the following:
- 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.
1. Early January (of the following year)
* Steering Committee finalizes [questions] and generates draft
`annual-report-YYYY.md` templates for each group in the community repo
* Steering Committee liaison reaches out to group leads to kick off
2. January-February
* Chairs/Organizers work with their group (see tips below) to open
a pull request to the group's documentation in the community repo,
updating the draft to complete the questions
* post a call for comments period on the PR with your group's mailing list;
you can follow your charter communication period if you have one,
but no less than 72 hours
* verify that Steering Liaison has reviewed
* merge a completed report by the end of February
3. March
* Steering Committee produces a project-wide annual report,
summarizing and highlighting elements from the individual group reports.
* The Steering Committee liaison will work directly with groups that have
follow up items and update Steering during regular monthly meetings. The liaison
will also coordinate time with the Chairs (as a group). If you'd like to meet
1:1 instead, please let your liaison know.
* The March edition of the "Chairs, Tech Leads, and Organizers" meetings will
be used as follow up for the community groups that have questions from/to
Steering and a retrospective
### Tips for Chairs and Working Group Organizers:
- 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.
- 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.
- If there are any private matters that you'd like to discuss as part of the
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
- The [questions] can be forked into whatever medium you wish to
collaborate with your community: gdocs, hackmd, etc - it will all land back into
a pull request at the end.
## Questions for report:
## Questions for report: {#questions}
#### Special Interest Groups:
##### Operational
@ -155,4 +125,4 @@ https://www.apache.org/foundation/board/reporting
[WG]: https://git.k8s.io/community/committee-steering/governance/wg-governance.md
[UG]: https://git.k8s.io/community/committee-steering/governance/ug-governance.md
[governance]: https://git.k8s.io/community/governance.md
[question template]: https://docs.google.com/document/d/1HeABRzhgF9NNpM0xGKLDhhc6bRfQuulsIsb59AjyS9M/edit#
[questions]: #questions