Skip to content

Commit df7fef4

Browse files
Suggestions incorporated into annual report
1 parent 8889003 commit df7fef4

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

sig-docs/annual-report-2021.md

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,17 @@
44

55
1. What work did the SIG do this year that should be highlighted?
66

7-
- SIG Docs put meaningful effort into growing its contributor and reviewer base in 2021, introducing a shadow program for PR Wrangling as well as dedicating more time to being active via our Slack community channel. This is an ongoing effort to grow our contributor base to a stable number, alongside easing the burden on our small group of reviewers and approvers.
7+
- SIG Docs put meaningful effort into growing its contributor and reviewer base in 2021, introducing [a shadow program for PR Wrangling](https://github.com/kubernetes/website/issues/31956) as well as dedicating more time to being active via our Slack community channel. This is an ongoing effort to grow our contributor base to a stable number, alongside easing the burden on our small group of reviewers and approvers.
88
- Alongside growing our contributor base, SIG Docs also worked on a leadership transition strategy to bring community members into leadership roles. Via a specialized six month mentorship program expertly led by Steering Committee member Paris Pittman, SIG Docs was able to grow its leadership cohort for the main SIG, as well as some of its subgroups, adding new co-chairs and tech leads.
9+
- [SIG Docs google group](https://groups.google.com/g/kubernetes-sig-docs/)
10+
- [Call for help sent to [email protected], kubernetes-sig-leads, kubernetes-sig-docs](https://groups.google.com/g/kubernetes-sig-docs/c/hspG6mzgkrs)
11+
- [Announcement of new roles and leadership nominations](https://groups.google.com/g/kubernetes-sig-docs/c/cgrAyDLxydk)
12+
913

1014
2. What initiatives are you working on that aren't being tracked in KEPs?
1115

12-
- Localization Subproject: SIG Docs is working on formalizing the localization work that has been ongoing for some time, with appointed leads of this initiative as well as recognizing the contributions of various community members across the different languages the Kubernetes website has been translated into. This subproject will be finalized by Q1 2022, with all active localizations informed and updated.
13-
- New Contributor Ambassador Program: As a continuation of our push to grow the SIG Docs contributor base, we're working on a specalized role that aims to support new and would-be contributors get up to speed with our processes and workflows. This role would be capped at six months for it to be shared amongst the community, with this feeding into a possible reviewer funnel as contributors get more comfortable with providing feedback to others.
16+
- Localization Subproject: SIG Docs is working on formalizing the localization work that has been ongoing for some time, with appointed leads of this initiative as well as recognizing the contributions of various community members across the different languages the Kubernetes website has been translated into. This subproject will be finalized by Q1 2022, with all active localizations informed and updated. The issue tracking the formalizing process can be viewed [here](https://github.com/kubernetes/website/issues/31955).
17+
- New Contributor Ambassador Program: As a continuation of our push to grow the SIG Docs contributor base, we're working on a specalized role that aims to support new and would-be contributors get up to speed with our processes and workflows. This role would be capped at six months for it to be shared amongst the community, with this feeding into a possible reviewer funnel as contributors get more comfortable with providing feedback to others. The issue tracking the formalization and documentation of this role can be viewed [here](https://github.com/kubernetes/website/issues/31946).
1418

1519
3. KEP work in 2021 (continuous and does not target any release):
1620

@@ -28,8 +32,8 @@ In future, this will be generated from kubernetes/enhancements kep.yaml files
2832
1. What areas and/or subprojects does your group need the most help with?
2933
Any areas with 2 or fewer OWNERs? (link to more details)
3034

31-
- Require more contributors to form a stable pool for SIG Docs
32-
- Require guidelines on how we could ramp up folks nominated to the New Contributor Ambassador role specific to SIG Docs.
35+
- Require more contributors to form a stable pool for the blog subproject, in particular and SIG Docs, generally.
36+
- Require guidelines on how we could ramp up folks nominated to the New Contributor Ambassador role specific to SIG Docs.
3337

3438
2. What metrics/community health stats does your group care about and/or measure?
3539

@@ -51,16 +55,18 @@ In future, this will be generated from kubernetes/enhancements kep.yaml files
5155
does your [CONTRIBUTING.md] document those to help **existing** contributors grow throughout the [contributor ladder]?
5256

5357
- We have a [well-documented guide](https://kubernetes.io/docs/contribute/) that details how folks can get started and the various ways in which they can scale the contributor ladder.
54-
- We actively assign good-first-issue labels to issues that we think early-lifecycle contributors could begin with. During KubeCons we also do introduction presentations and mentoring sessions to try and funnel contributors in to our SIG.
58+
- We actively assign good-first-issue labels to issues that we think early-lifecycle contributors could begin with. During KubeCons we also do introduction presentations and mentoring sessions to try and funnel contributors in to our SIG. Some of them are listed below,
59+
- [Intro to Kubernetes Docs](https://www.youtube.com/watch?v=pprMgmNzDcw), presented at KubeCon NA, 2020
60+
- [Kubernetes SIG Docs: A Deep Dive](https://www.youtube.com/watch?v=GDfcBF5et3Q), presented at KubeCon NA, 2021
5561

5662
5. Does the group have contributors from multiple companies/affiliations?
5763

58-
- [98 companies](https://k8s.devstats.cncf.io/d/8/company-statistics-by-repository-group?orgId=1&var-period=y&var-metric=contributions&var-repogroup_name=SIG%20Docs&var-repo_name=kubernetes%2Fkubernetes&var-companies=All&from=1609455600000&to=1639350000000)
64+
- We have a contributor base spread across [98 companies](https://k8s.devstats.cncf.io/d/8/company-statistics-by-repository-group?orgId=1&var-period=y&var-metric=contributions&var-repogroup_name=SIG%20Docs&var-repo_name=kubernetes%2Fkubernetes&var-companies=All&from=1609455600000&to=1639350000000) with top 50% contributions coming our way from IBM, Google, VMWare, RedHat, and NEC Corporation. We are al
5965

6066
6. Are there ways end users/companies can contribute that they currently are not?
6167
If one of those ways is more full time support, what would they work on and why?
6268

63-
- We're in the process of formalizing the localization subproject. We aim for it to, potentially, provide more avenues for contribution. More details around leadership for the localization supbproject can be found in [this message](https://groups.google.com/a/kubernetes.io/g/dev/c/SP6weMvx3wg/m/l8LAL-OFCQAJ) sent to [email protected]
69+
- With a contributor base that is spread globally, SIG Docs identified a potential opportunity for diversifying our documentation via multiple language support. Given the wide audience, this helps in making it more inclusive and user friendly for non-native English users of Kubernetes. Towards formalizing this ongoing initiative, SIG Docs will be finalizing it as a [localization subproject](https://github.com/kubernetes/website/issues/31955). We aim for the subproject to, potentially, provide more avenues for contribution. More details around leadership and the formalization process can be found in [this message](https://groups.google.com/a/kubernetes.io/g/dev/c/SP6weMvx3wg/m/l8LAL-OFCQAJ) sent to [email protected]
6470

6571
## Membership
6672

@@ -100,6 +106,8 @@ Operational tasks in [sig-governance.md]:
100106
- [x] Meeting notes and recordings for 2021 are linked from [README.md] and updated/uploaded if needed
101107
- [x] Did you have community-wide updates in 2021 (e.g. community meetings, kubecon, or kubernetes-dev@ emails)? Links to email, slides, or recordings:
102108
- [Kubernetes SIG Docs: A Deep Dive](https://www.youtube.com/watch?v=GDfcBF5et3Q), presented at KubeCon NA, 2021
109+
- [SIG Docs needs your help! to [email protected]](https://groups.google.com/g/kubernetes-sig-docs/c/hspG6mzgkrs)
110+
- [SIG Docs Co-Chair Nomination: Divya Mohan to [email protected]](https://groups.google.com/g/kubernetes-sig-docs/c/_1R7sh-_iiQ)
103111
- [SIG Docs: New roles & leadership nominations to [email protected]](https://groups.google.com/a/kubernetes.io/g/dev/c/SP6weMvx3wg/m/l8LAL-OFCQAJ)
104112
- [SIG Docs APAC Meeting has changed to 1 AM IST/5.30 AM UTC on the last Wednesday of every month to [email protected]](https://groups.google.com/g/kubernetes-sig-docs/c/P7iLejmEIFA/m/-dPsBOpoDAAJ)
105113

0 commit comments

Comments
 (0)