Skip to content

Commit c4d984c

Browse files
authored
Update annual-report-2023.md
1 parent 94846ce commit c4d984c

File tree

1 file changed

+16
-18
lines changed

1 file changed

+16
-18
lines changed

sig-docs/annual-report-2023.md

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,31 +4,28 @@
44

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

7-
<!--
8-
Some example items that might be worth highlighting:
9-
- Major KEP advancement
10-
- Important initiatives that aren't tracked via KEPs
11-
- Paying down significant tech debt
12-
- Governance and leadership changes
13-
-->
7+
- SIG Docs completely [removed the Katacoda tutorials catalog](https://github.com/kubernetes/website/discussions/38878), previously shared as new user resources, after this content was reclaimed behind a paywall for O'Reilly subscribers. We are still looking for a replacement set of resources
8+
- The [Issue Wrangler role](https://github.com/kubernetes/website/discussions/38861) was formalized in the SIG, which introduced a new named role to help triage and categorize SIG Docs issues. This role follows the roster system currently in place for PR Wranglers, but opens up the possibilty of seasoned contributors who *aren't* approvers to additionally contribute to the SIG
9+
- SIG Docs worked with SIG Release and the Release Team Subproject to introduce new and improved processes for documentation during each release. This includes initiating a [Docs Freeze](https://github.com/kubernetes/sig-release/pull/2383) as part of the release calendar deadlines, creating [better handbook guideance](https://github.com/kubernetes/sig-release/pull/2350) for weekly status updates, as well as a more robust process for removing shadows/leads who fail to fulfil their role (seen specifically across Docs/Comms for the last few releases)
10+
- The New Contributor Ambassador has been replaced, after Arsh Sharma served in this role for over two years. We thank Arsh and welcome our now-current New Contributor Ambassador, Sreeram Venkitesh!
11+
- SIG Docs served as one of the first SIGs to setup and trial the new YouTube automation project lead by SIG Contributor Experience for all community meeting uploads
12+
- SIG Docs leadership created [onboarding and offboarding documentation and processes](https://github.com/kubernetes/website/discussions/38842) for Co-chairs and Tech Leads, alongside an annualized list of activities and work the SIG Docs leadership team is responsible for
13+
- We have initiated the start of a possible Translation Platform test for our localization teams, with more work on this initiative continuing in 2024
1414

1515
2. Are there any areas and/or subprojects that your group needs help with (e.g. fewer than 2 active OWNERS)?
1616

17-
<!--
18-
Note: This list is generated from the KEP metadata in kubernetes/enhancements repository.
19-
If you find any discrepancy in the generated list here, please check the KEP metadata.
20-
Please raise an issue in kubernetes/community, if the KEP metadata is correct but the generated list is incorrect.
21-
-->
17+
- The Kubernetes Blog Subproject currently only has one active editor, as we attempt to onboard further people to the blog reviewing team. This is a strain both on the usual blog work we have, as well as feature blogs linked with each Kubernetes release
18+
- The Reference Docs Subproject is currently lacking true ownership and process outlines, which we hope to solve via recruiting further Tech Leads for the SIG (currently in progress). At present, this subproject is understaffed
19+
- SIG Docs is currently in a state of flux regarding leadership: three Tech Leads will step down in 2024, while we have actively recruited/replaced two of these positions
2220

2321
3. Did you have community-wide updates in 2023 (e.g. KubeCon talks)?
2422

25-
<!--
26-
Examples include links to email, slides, or recordings.
27-
-->
23+
- KubeCon/CloudNativeCon EU 2023 Maintainer Track: [How To Localize Kubernetes Documentation – A Guide For Everyone](https://youtu.be/Ng8QwklOwe0)
24+
- KubeCon/CloudNativeCon NA 2023 Maintainer Track: [Docs Drive Adoption – Help Wanted!](https://www.youtube.com/watch?v=R4RDZ-rLNJo)
2825

2926
4. KEP work in 2023 (v1.27, v1.28, v1.29):
3027

31-
28+
* N/A
3229

3330

3431
## [Subprojects](https://git.k8s.io/community/sig-docs#subprojects)
@@ -42,16 +39,17 @@
4239

4340
## [Working groups](https://git.k8s.io/community/sig-docs#working-groups)
4441

42+
* N/A
4543

4644
## Operational
4745

4846
Operational tasks in [sig-governance.md]:
4947
- [ ] [README.md] reviewed for accuracy and updated if needed
5048
- [ ] [CONTRIBUTING.md] reviewed for accuracy and updated if needed
5149
- [ ] Other contributing docs (e.g. in devel dir or contributor guide) reviewed for accuracy and updated if needed
52-
- [ ] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed
50+
- [x] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed
5351
- [ ] SIG leaders (chairs, tech leads, and subproject leads) in [sigs.yaml] are accurate and active, and updated if needed
54-
- [ ] Meeting notes and recordings for 2023 are linked from [README.md] and updated/uploaded if needed
52+
- [x] Meeting notes and recordings for 2023 are linked from [README.md] and updated/uploaded if needed
5553

5654

5755
[CONTRIBUTING.md]: https://git.k8s.io/community/sig-docs/CONTRIBUTING.md

0 commit comments

Comments
 (0)