|
1 | | -# 2024 Annual Report: SIG Docs |
| 1 | +***1. What work did the SIG do this year that should be highlighted?*** |
| 2 | +* Karen Bradshaw, Tim Bannister, and Taylor Dolezal stepped down as SIG Docs Tech Leads. Kat Cosgrove and Xander Grzywinski were appointed as new Tech Leads. |
| 3 | +* While not a success, SIG Docs took 2024 to explore options around translation tooling for localizations, however, staffing changes meant it couldn't be prioritized in time. The `localization` subproject will own this exploration for 2025 and beyond. |
2 | 4 |
|
3 | | -## Current initiatives and Project Health |
| 5 | +***2. Are there any areas and/or subprojects that your group needs help with (e.g. fewer than 2 active OWNERS)?*** |
| 6 | +* We continue to require help with the `kubernetes-blog` subproject. While we have separated tasks based on needs for release blogs and general blog posts, our blog team still needs more staff. |
| 7 | +* The `reference-docs` subproject is slowly being revived, with some refactoring planned to bring on more contributors. Kat Cosgrove and Xander Grzywinski, our new Tech Leads, will be elevated to OWNERS. |
| 8 | +* As part of our [annual updation of the OWNERS file](https://github.com/kubernetes/website/pull/49273), we found that two of our localisations are at risk due to there being only one active approver/reviewer. SIG leads [have requested](https://kubernetes.slack.com/archives/C0191RDKHU1/p1739338503630329?thread_ts=1735797874.143339&cid=C0191RDKHU1) the localisation subproject leads to reach out to the respective localisations and also, feature this as a discussion item in the upcoming localisation meeting to understand how to better support them. |
4 | 9 |
|
5 | | -1. What work did the SIG do this year that should be highlighted? |
6 | | - |
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 | | ---> |
14 | | - |
15 | | -2. Are there any areas and/or subprojects that your group needs help with (e.g. fewer than 2 active OWNERS)? |
16 | | - |
17 | | - |
18 | | -3. Did you have community-wide updates in 2024 (e.g. KubeCon talks)? |
19 | | - |
20 | | -<!-- |
21 | | - Examples include links to email, slides, or recordings. |
22 | | ---> |
23 | | - |
24 | | -4. KEP work in 2024 (v1.30, v1.31, v1.32): |
25 | | -<!-- |
26 | | - TODO: Uncomment the following auto-generated list of KEPs, once reviewed & updated for correction. |
27 | | -
|
28 | | - Note: This list is generated from the KEP metadata in kubernetes/enhancements repository. |
29 | | - If you find any discrepancy in the generated list here, please check the KEP metadata. |
30 | | - Please raise an issue in kubernetes/community, if the KEP metadata is correct but the generated list is incorrect. |
31 | | ---> |
32 | | - |
33 | | -<!-- |
34 | | -
|
35 | | - --> |
36 | | - |
37 | | -## [Subprojects](https://git.k8s.io/community/sig-docs#subprojects) |
38 | | - |
39 | | - |
40 | | -**Continuing:** |
41 | | - - kubernetes-blog |
42 | | - - localization |
43 | | - - reference-docs |
44 | | - - website |
45 | | - |
46 | | -## [Working groups](https://git.k8s.io/community/sig-docs#working-groups) |
47 | | - |
48 | | - |
49 | | -## Operational |
| 10 | +***3. Did you have community-wide updates in 2024 (e.g. KubeCon talks)?*** |
| 11 | +* Document Your Career Path with SIG Docs! (Rey Lejano, Red Hat and Divya Mohan, SUSE): https://kccnceu2024.sched.com/event/1Yhj9/document-your-career-path-with-sig-docs-rey-lejano-red-hat-divya-mohan-suse |
| 12 | +* Navigating Cross-SIG Collaborations With SIG Docs (Savitha Raghunathan, Red Hat, Divya Mohan, SUSE, Xander Grzywinski, Independent, and Rey Lejano, Red Hat): https://kccncna2024.sched.com/event/1hox8/navigate-cross-sig-collaborations-with-sig-docs-rey-lejano-savitha-raghunathan-red-hat-divya-mohan-suse-xander-grzywinski-defense-unicorns |
50 | 13 |
|
51 | 14 | Operational tasks in [sig-governance.md]: |
52 | | -- [ ] [README.md] reviewed for accuracy and updated if needed |
53 | | -- [ ] [CONTRIBUTING.md] reviewed for accuracy and updated if needed |
54 | | -- [ ] Other contributing docs (e.g. in devel dir or contributor guide) reviewed for accuracy and updated if needed |
55 | | -- [ ] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed |
56 | | -- [ ] SIG leaders (chairs, tech leads, and subproject leads) in [sigs.yaml] are accurate and active, and updated if needed |
57 | | -- [ ] Meeting notes and recordings for 2024 are linked from [README.md] and updated/uploaded if needed |
58 | | - |
59 | | - |
60 | | -[CONTRIBUTING.md]: https://git.k8s.io/community/sig-docs/CONTRIBUTING.md |
61 | | -[sig-governance.md]: https://git.k8s.io/community/committee-steering/governance/sig-governance.md |
62 | | -[README.md]: https://git.k8s.io/community/sig-docs/README.md |
63 | | -[sigs.yaml]: https://git.k8s.io/community/sigs.yaml |
64 | | -[devel]: https://git.k8s.io/community/contributors/devel/README.md |
| 15 | +- [x] [README.md] reviewed for accuracy and updated if needed |
| 16 | +- [x] [CONTRIBUTING.md] reviewed for accuracy and updated if needed |
| 17 | +- [x] Other contributing docs (e.g. in devel dir or contributor guide) reviewed for accuracy and updated if needed |
| 18 | +- [x] Subprojects list and linked OWNERS files in [sigs.yaml] reviewed for accuracy and updated if needed |
| 19 | +- [x] SIG leaders (chairs, tech leads, and subproject leads) in [sigs.yaml] are accurate and active, and updated if needed |
| 20 | +- [x] Meeting notes and recordings for 2024 are linked from [README.md] and updated/uploaded if needed |
0 commit comments