Skip to content

Commit

Permalink
Update annual report SIG template
Browse files Browse the repository at this point in the history
  • Loading branch information
liggitt committed Jan 4, 2022
1 parent 8a88015 commit 3de9023
Showing 1 changed file with 129 additions and 37 deletions.
166 changes: 129 additions & 37 deletions committee-steering/governance/annual-reports.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,43 +64,135 @@ a pull request at the end.

## Questions for report:

#### Special Interest Groups:
##### Operational
- How are you doing with operational tasks in [SIG]-governance.md?
- Is your README accurate? have a CONTRIBUTING.md file?
- All subprojects correctly mapped and listed in sigs.yaml?
- What’s your meeting culture? Large/small, active/quiet, learnings? Meeting
notes up to date? Are you keeping recordings up to date/trends in community
members watching recordings?
- How does the group get updates, reports, or feedback from subprojects? Are
there any springing up or being retired? Are OWNERS.md files up to date in these
areas?
- Same question as above but for working groups.
- When was your last public community-wide update? (provide link to deck and/or
recording)

##### Membership
- Are all listed SIG leaders (chairs, tech leads, and subproject owners) active?
- How do you measure membership? By mailing list members, OWNERs, or something
else?
- How does the group measure reviewer and approver bandwidth? Do you need help
in any area now? What are you doing about it?
- Is there a healthy onboarding and growth path for contributors in your SIG?
What are some activities that the group does to encourage this? What programs
are you participating in to grow contributors throughout the contributor ladder?
- What programs do you participate in for new contributors?
- Does the group have contributors from multiple companies/affiliations? Can end
users/companies contribute in some way that they currently are not?

##### Current initiatives and project health
- What are initiatives that should be highlighted, lauded, shout outs, that
your group is proud of? Currently underway? What are some of the longer tail
projects that your group is working on?
- Year to date KEP work: What's now stable? Beta? Alpha? Road to alpha?
- What initiatives are you working on that aren't being tracked in KEPs?
- What areas and/or subprojects does the group need the most help with?
- What metrics/community health stats does your group care about and/or measure?
Examples?
### Special Interest Groups:

```
# {sig-name} - {YYYY} annual report
## Current initiatives
1. What work did the SIG do this year that should be highlighted?
-
-
-
2. What initiatives are you working on that aren't being tracked in KEPs?
-
-
-
3. KEP work in {YYYY} (1.x, 1.y, 1.z): (generated)
- Stable
- [{name}]({KEP link}) - {release}
- [{name}]({KEP link}) - {release}
- Beta
- [{name}]({KEP link}) - {release}
- [{name}]({KEP link}) - {release}
- Alpha
- [{name}]({KEP link}) - {release}
- [{name}]({KEP link}) - {release}
- Pre-alpha
- [{name}]({KEP link})
## Project health
1. What areas and/or subprojects does your group need the most help with?
Any areas with 2 or fewer OWNERs? (link to more details)
-
-
-
2. What metrics/community health stats does your group care about and/or measure?
-
-
-
3. Does your [CONTRIBUTING.md] help **new** contributors engage with your group specifically by pointing
to activities or programs that provide useful context or allow easy participation?
-
4. Does your [CONTRIBUTING.md] help **existing** contributors grow throughout the [contributor ladder]
by documenting any special training, requirements, or processes unique to reviewers/approvers in your group?
-
5. Does the group have contributors from multiple companies/affiliations?
-
6. Are there ways end users/companies can contribute that they currently are not?
If one of those ways is more full time support, what would they work on and why?
-
-
## Membership
- Primary slack channel member count:
- Primary mailing list member count:
- Primary meeting attendee count (estimated, if needed):
- Primary meeting participant count (estimated, if needed):
- Unique reviewers for SIG-owned packages: {generated}
- Unique approvers for SIG-owned packages: {generated}
Include any other ways you measure group membership
## Subprojects (generated)
New in {YYYY}:
- {name}
- {name}
Retired in {YYYY}:
-
-
Continuing:
-
-
## Working groups (generated)
New in {YYYY}:
- [{name}]({link to community repo dir}) {link to YYYY annual report}
-
Retired in {YYYY}:
-
-
Continuing:
-
-
## Operational
Operational tasks in [sig-governance.md]:
[ ] [README.md] reviewed for accuracy and updated if needed
[ ] [CONTRIBUTING.md] reviewed for accuracy and updated if needed
(or created if missing and your contributor steps and experience are different or more
in-depth than the documentation listed in the general [contributor guide] and [devel] folder.)
[ ] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed
[ ] SIG leaders (chairs, tech leads, and subproject owners) in [sigs.yaml] are accurate and active, and updated if needed
[ ] Meeting notes and recordings for {YYYY} are linked from [README.md] and updated/uploaded if needed
[ ] Did you have community-wide updates in {YYYY} (e.g. community meetings, kubecon, or kubernetes-dev@ emails)? Links to email, slides, or recordings:
-
-
[CONTRIBUTING.md]: https://git.k8s.io/community/{sig-id}/CONTRIBUTING.md
[contributor ladder]: https://git.k8s.io/community/community-membership.md
[sig-governance.md]: https://git.k8s.io/community/committee-steering/governance/sig-governance.md
[README.md]: https://git.k8s.io/community/{sig-id}/README.md
[sigs.yaml]: https://git.k8s.io/community/sigs.yaml
[contributor guide]: https://git.k8s.io/community/contributors/guide/README.md
[devel]: https://git.k8s.io/community/contributors/devel/README.md
```

### Working Groups:
Working Group Organizers are responsible for submitting this report but may
Expand Down

0 comments on commit 3de9023

Please sign in to comment.