Skip to content

Commit 364cc8c

Browse files
committed
Add new directory for workflow / template details
The original "templates" directory contained not just templates but more overview of each deliverables Comms support with. Because the main README file contains more of the general guideline of what Comms does, it is useful to have another document detailng more about how Comms team can work with schedule and deadlines in mind. Also, this commit introduces the placeholder issue ticket for subteam progress tracking.
1 parent 174f07e commit 364cc8c

File tree

2 files changed

+373
-0
lines changed

2 files changed

+373
-0
lines changed
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Comms Workflows
2+
3+
The Comms team handles multiple aspects, and each has distinct workflow and actions associated. This directory contains those templates we can use for outreach, as well as explanation on how we can adjust as necessary.
4+
5+
## Schedule and Action Plans
6+
7+
In general, the Comms team is very action heavy towards the end of the cycle, i.e. from week 7+. This means it only starts slowly, but when it comes to the crunch time, everything seems to happen all at once, causing quite a bit of time pressure for the team, and any related parties. Because of that characteristics, it is important to keep deadlines in mind to be ahead of the game.
8+
9+
- Around week 11: Mid Cycle Blog publication
10+
- Around week 11: Release Highlights deadline
11+
- On the release day: Release Blog published
12+
- A day after the release day: one Feature Blog published per day
13+
14+
As the Enhancement freeze tends to take place around week 5, we should be able to start preparing as early as week 5.
15+
16+
## Progress Tracking Issue
17+
18+
> [!NOTE]
19+
> Quick Summary: Create an issue with all the schedule and details
20+
21+
Most of the progress can be found in the Release Team meeting agenda / minutes, but it does not show all the action items for the future. In order to keep everyone including teams and people outside of the Comms team, it is useful to have a dedicated progress tracking ticket.
22+
23+
You can find the template here.
24+
25+
## Mid Cycle Blog
26+
27+
> [!NOTE]
28+
> Quick Summary: Discuss with Release Leads in Slack Group DM, start internal draft using Google Doc / HackMD / etc., create Pull Request in k/website to publish
29+
30+
The Mid Cycle Blog, formerly known as "Deprecations and Removals" blog, is used to highlight upcoming deprecations to educate users early so that the upgrade can be smooth for them. Not every release has a significant deprecation / removal, and thus this blog is not mandatory. You should discuss with **Release Lead + Enhancement Lead in the group DM** whether we should have the mid cycle blog or not.
31+
32+
In case you need one, you would want to start with a Google Doc or HackMD internal draft, so that the Comms team can start working on the draft first.
33+
34+
35+
## Release Highlights
36+
37+
Lines changed: 336 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,336 @@
1+
# Progress Tracking Issue
2+
3+
The below is the content full content of the progress tracking issue. Replace all the `v1.XX` references to the target release.
4+
5+
Example tickets:
6+
7+
- v1.33 https://github.com/kubernetes/sig-release/issues/2718
8+
- v1.32 https://github.com/kubernetes/sig-release/issues/2625
9+
10+
-----
11+
12+
> [!NOTE]
13+
> This ticket follows the [Release Team Lead Cycle Progress ticket](https://github.com/kubernetes/sig-release/issues/XXXX), and is curated for Comms specific actions and plans. More of release information can be found in [/releases/release-1.XX/README.md](https://github.com/kubernetes/sig-release/blob/master/releases/release-1.XX/README.md).
14+
15+
16+
# Overview
17+
18+
## Latest Update
19+
20+
As of Monday, xx January (week 1)
21+
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
22+
23+
## Currently Tracked Goals
24+
25+
- [ ] Feature Blogs
26+
- [ ] Opt-in Outreach
27+
- [ ] Mid Cycle Sneak Peek Blog
28+
- [ ] Internal write-up
29+
- [ ] Official PR
30+
- [ ] Release Announcements
31+
- [ ] Release Highlights
32+
- [ ] Internal write-up
33+
- [ ] Official PR
34+
- [ ] Webinar and Press
35+
- [ ] Schedule with CNCF
36+
- [ ] Coordinate interview setup with press
37+
- [ ] Hold webinar
38+
39+
## Useful Links
40+
41+
- [v1.XX Schedule and Information](https://github.com/kubernetes/sig-release/blob/master/releases/release-1.XX/README.md)
42+
- [Templates for various reach-out / drafts](https://github.com/kubernetes/sig-release/tree/master/release-team/role-handbooks/communications/templates)
43+
- Enhancement Tracking Board: _(TBC)_
44+
- **Mid Cycle Blog**
45+
- Comms team internal draft: _(TBC)_
46+
- PR for official blog: _(TBC)_
47+
- Previous Mid Cycle Blogs: [v1.29](https://kubernetes.io/blog/2023/11/16/kubernetes-1-29-upcoming-changes/), [v1.30](https://kubernetes.io/blog/2024/03/12/kubernetes-1-30-upcoming-changes/), [v1.31](https://kubernetes.io/blog/2024/07/19/kubernetes-1-31-upcoming-changes/), [v1.32](https://kubernetes.io/blog/2024/11/08/kubernetes-1-32-upcoming-changes/), [v1.33](https://kubernetes.io/blog/2025/03/26/kubernetes-v1-33-upcoming-changes/)
48+
- Published blog: _(TBC)_
49+
- **Release Highlight**
50+
- Release Highlights contact issue: _(TBC)_
51+
- Release Highlights discussion: _(TBC)_
52+
- **Release Announcement**
53+
- Comms team internal draft: _(TBC)_
54+
- PR for official blog: _(TBC)_
55+
- Previous Release Announcements: [v1.29](https://kubernetes.io/blog/2023/12/13/kubernetes-v1-29-release/), [v1.30](https://kubernetes.io/blog/2024/04/17/kubernetes-v1-30-release/), [v1.31](https://kubernetes.io/blog/2024/08/13/kubernetes-v1-31-release/), [v1.32](https://kubernetes.io/blog/2024/12/11/kubernetes-v1-32-release/), [v1.33](https://kubernetes.io/blog/2025/04/23/kubernetes-v1-33-release/)
56+
57+
# Schedule and Details
58+
59+
## Week 1, 2: Onboarding
60+
61+
Comms work tend to focus more towards the latter half of the release schedule, and thus this is the time to prepare for the team setup.
62+
63+
### For Lead
64+
65+
* [ ] Onboard the shadows
66+
* [ ] Select the shadows
67+
* [ ] Prepare the onboarding presentation
68+
* [ ] Run down Comms expectation in a meeting
69+
* [ ] Provide all the relevant information for the action items for the shadows
70+
* [ ] Update contact details for the shadows in the release contact sheet
71+
* [ ] Update the `k/org`'s [/config/kubernetes/sig-release/teams.yaml](https://github.com/kubernetes/org/blob/main/config/kubernetes/sig-release/teams.yaml)
72+
- This gives access to the [Comms Project Board](https://github.com/orgs/kubernetes/projects/195/views/4) (Link to be fixed)
73+
- We need the lead and shadows to be listed as milestone maintainers
74+
* [ ] Add the lead
75+
* [ ] Add the shadows
76+
* [ ] Setup Comms Project Board
77+
* [ ] Copy "Comms - All" project board
78+
* [ ] Copy "Comms - Feature Blogs" project board
79+
* [ ] Adjust the filter setup for "Comms - Feature Blogs" to ensure anyone can find the current progress with Feature Blog status
80+
81+
### For Shadows
82+
83+
> [!TIP]
84+
> Although many actions need to be handled by the shadows themselves, it is important for the lead to guide to the right information and material for proceeding with them.
85+
86+
* [ ] Create [membership request issue](https://github.com/kubernetes/org/issues/new?template=membership.yml) in `k/org` (if not already members)
87+
* [ ] Sign the CLA
88+
* [ ] Subscribe to the Kubernetes release calendar
89+
* [ ] Join the Slack channels related to Release Teams
90+
- [#sig-release](https://kubernetes.slack.com/archives/C2C40FMNF)
91+
- [#sig-docs](https://kubernetes.slack.com/archives/C1J0BPD2M)
92+
- [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J)
93+
- [#release-comms](https://kubernetes.slack.com/archives/CNT9Y603D)
94+
- Also, there are other Release related channels worth joining
95+
- [#release-ci-signal](https://kubernetes.slack.com/archives/CN0K3TE2C)
96+
- [#release-notes](https://kubernetes.slack.com/archives/CN1KH4K9A)
97+
- [#release-docs](https://kubernetes.slack.com/archives/C0156PJ62RE)
98+
- [#release-enhancements](https://kubernetes.slack.com/archives/C02BY55KV7E)
99+
- [#release-management](https://kubernetes.slack.com/archives/CJH2GBF7Y)
100+
* [ ] Schedule and attend the mandatory shadow orientation (general)
101+
* [ ] Schedule and attend the Comms shadow onboarding
102+
103+
### Status Summary / Note for Reference
104+
105+
- TBC
106+
107+
## Week 3, 4, 5, 6, 7: Tracking
108+
109+
The main tracking starts as the enhancement freeze comes into play.
110+
111+
For v1.XX, the enhancement freeze takes place on week {{X}}.
112+
113+
### For Lead
114+
115+
* [ ] Have a clear picture of what to expect with Release Lead and other Subteam Leads
116+
* [ ] List all major changes to be included in this release with the Release Lead and Enhancements Lead
117+
* [ ] List most noteworthy deliverables post-Enhancements freeze with Enhancements and Docs Leads
118+
* [ ] Prepare the Comms board with Feature Blog opt-in reach-out assignees
119+
* [ ] With Enhancement freeze in effect (in week 5), prepare for Release Highlights
120+
* [ ] Create a GitHub Discussion: _(TBC)_
121+
- This can be used to collect the Release Highlights from various SIGs and KEP owners
122+
- [Template](https://github.com/kubernetes/sig-release/blob/master/release-team/role-handbooks/communications/templates/release-highlights-discussion.md)
123+
- Example: [v1.26](https://github.com/kubernetes/sig-release/discussions/2047), [v1.32](https://github.com/kubernetes/sig-release/discussions/2639), [v1.33](https://github.com/kubernetes/sig-release/discussions/2734)
124+
* [ ] Create a GitHub Issue: _(TBC)_
125+
- This is more for internal tracking within Comms team
126+
- [Template](https://github.com/kubernetes/sig-release/blob/master/release-team/role-handbooks/communications/templates/release-highlights-tracking-issue.md)
127+
- Example: [v1.32](https://github.com/kubernetes/sig-release/issues/2640), [v1.33](https://github.com/kubernetes/sig-release/issues/2735)
128+
* [ ] Work with the Release Team and decide if the release warrants a Mid Cycle Blog
129+
130+
### For Lead and Shadows
131+
132+
* [ ] Start reaching out for Feature Blog opt-in for each KEP
133+
* [ ] Complete the first round of reach-out
134+
* [ ] Complete the second round of reach-out
135+
* [ ] Reach out to all SIGs for their input on Release Highlights
136+
- The deadline would be much later, and we should mark the initial reach-out
137+
138+
### Status Summary / Note for Reference
139+
140+
- TBC
141+
142+
## Week 8: Feature Blog Deadline + Mid Cycle Blog
143+
144+
TBC
145+
146+
<!--
147+
Update as necessary. The below is for reference from v1.33.
148+
149+
For v1.33, the Feature Blog freeze takes place on week 8. Also, the Mid Cycle Sneak Peek blog is set to be published on week 11, and thus we would need to start the sneak peek blog draft early enough. The week 8 is a good target to keep in mind.
150+
-->
151+
152+
### For Lead
153+
* [ ] Start drafting the mid cycle sneak peek blog
154+
- The initial draft can happen outside PR
155+
- Previous Mid Cycle Blogs:: [v1.29](https://kubernetes.io/blog/2023/11/16/kubernetes-1-29-upcoming-changes/), [v1.30](https://kubernetes.io/blog/2024/03/12/kubernetes-1-30-upcoming-changes/), [v1.31](https://kubernetes.io/blog/2024/07/19/kubernetes-1-31-upcoming-changes/), [v1.32](https://kubernetes.io/blog/2024/11/08/kubernetes-1-32-upcoming-changes/)
156+
157+
### For Lead and Shadows
158+
* [ ] Update and finalise the Feature Blog status in the Project Board
159+
160+
### Status Summary / Note for Reference
161+
162+
- TBC
163+
164+
## Week 9: Focus on Mid Cycle Blog
165+
166+
TBC
167+
168+
<!--
169+
Update as necessary. The below is for reference from v1.33.
170+
171+
As the mid cycle blog needs to be reviewed by the SIG Docs Blog team, the target is to get the blog ready for review this week, getting ready for the publish target of early week 11 for v1.33.
172+
-->
173+
174+
### For Lead
175+
* [ ] Create the mid cycle sneak peek blog PR
176+
* [ ] Collaborate with sig-docs-blog to establish review expectations and publication strategy
177+
* [ ] Notify sig-docs-blog about the review of the mid cycle sneak peek blog
178+
* [ ] Assign Feature Blogs to each member and clarify in the "Comms Editor" column
179+
180+
### For Lead and Shadows
181+
* [ ] Send another reminder to SIGs about Release Highlights
182+
183+
### Status Summary / Note for Reference
184+
185+
- TBC
186+
187+
## Week 10: Release Blog Draft & Mid Way Retro
188+
TBC
189+
190+
<!--
191+
Update as necessary. The below is for reference from v1.33.
192+
193+
For v1.33, the code freeze takes place this week. The deadline of Release Highlights is week after (week 11), and thus we start preparing for the Release Announcements write-up
194+
-->
195+
196+
### For Lead
197+
* [ ] Start drafting the Release Announcement blog
198+
- The initial draft can happen outside PR
199+
- Previous Release Announcements: [v1.29](https://kubernetes.io/blog/2023/12/13/kubernetes-v1-29-release/), [v1.30](https://kubernetes.io/blog/2024/04/17/kubernetes-v1-30-release/), [v1.31](https://kubernetes.io/blog/2024/08/13/kubernetes-v1-31-release/), [v1.32](https://kubernetes.io/blog/2024/12/11/kubernetes-v1-32-release/), [v1.33](https://kubernetes.io/blog/2025/04/23/kubernetes-v1-33-release/)
200+
201+
### For Lead and Shadows
202+
A bit of slow time other than the mid cycle blog to be finalised.
203+
* [ ] Join retrospective for sharing anything you learned from the cycle so far
204+
205+
### Status Summary / Note for Reference
206+
- TBC
207+
208+
## Week 11: Mid Cycle Blog Published + Start of Burndown Meetings
209+
TBC
210+
211+
<!--
212+
Update as necessary. The below is for reference from v1.33.
213+
214+
The mid cycle blog goes out, and Release Highlight deadline is on this week. With the code freeze done in the previous week, we should be ready for getting more contents in place for the Release Announcement. However, for this release, we need to note how KubeCon takes place in the week after, and some of the schedule may need to be tweaked due to that.
215+
-->
216+
217+
### For Lead
218+
There are many items in week, and anything that couldn't get completed should be carried over in the week after (which is during KubeCon).
219+
220+
* [ ] Publish the mid cycle sneak peek blog (24th March, 2025)
221+
* [ ] Make sure Release Highlights details are shared in the discussion ticket
222+
- This is to ensure transparency for all the Release teams
223+
* [ ] Review Feature Blog assignment following the code freeze, and re-assign as necessary
224+
* [ ] Run down the Release Announcement details for the team
225+
* [ ] Schedule the release Live Webinar with CNCF by emailing `[email protected]`. You may be referred to [Calendly](https://calendly.com/cncfonlineprograms). The webinar is typically scheduled for 3-4 weeks after the release.
226+
* [ ] Schedule press and analyst pre-briefings and interviews for the release lead with CNCF by emailing `[email protected]`
227+
* [ ] Schedule release blog and press embargo with the CNCF
228+
* [ ] Discuss the Release Highlights status with the Release Lead, Enhancements Lead, and Docs Lead (during the RT meeting)
229+
* [ ] Establish Feature Blog publication schedule, typically 2-3 posts per week, at least starting a day after the release blog.
230+
* [ ] Establish a regular cadence status check-in with the `#sig-docs-blog` team and maintain the publication schedule post in Slack to keep everyone synced
231+
* [ ] Choose the next Comms Lead
232+
233+
### For Lead and Shadows
234+
* [ ] Send final reminder about the Release Highlights (the deadline is on Tuesday, 25th March, 2025)
235+
* [ ] Join burndown meetings
236+
- As of writing (22nd March), the burndown meeting is likely to take place asynchronously on Slack
237+
- Lead or shadows will be asked to provide the RAG (Red Amber Green) status
238+
* [ ] Send a reminder to Feature Blog authors (deadline on week 13)
239+
- Once the write-up is ready for review, we need to ensure we have the right parties engaged in the review (sig-docs-blog, associated SIGs, etc.).
240+
* [ ] Prepare Feature Blog publication schedule internally
241+
- Once finalised, the schedule needs to be shared in `#sig-docs-blog`
242+
* [ ] Start writing up Release Announcement blog draft
243+
- Each member should have a handful of sections to work on
244+
- Ensure each of the Release Highlights gets a one-to-two paragraph summary, following updates from SIGs
245+
246+
### Status Summary / Note for Reference
247+
- TBC
248+
249+
## Week 12: Placeholder (KubeCon)
250+
TBC
251+
252+
<!--
253+
Update as necessary. The below is for reference from v1.33.
254+
255+
Because of KubeCon taking place, this week would be light in terms of the actions. However, as the many of the actions have started from week 11, any work should continue in this week, especially around the Release Announcement write-up which takes quite some time.
256+
257+
Also, if you are attending KubeCon, join the maintainer summit to meet the team!
258+
-->
259+
260+
261+
## Week 13: Crunch time
262+
TBC
263+
264+
<!--
265+
Update as necessary. The below is for reference from v1.33.
266+
267+
For v1.33, Feature Blog reviews start taking place from week 13.
268+
-->
269+
270+
### For Lead
271+
* [ ] Check status with Docs lead on content for the Known Issues section of the release blog
272+
* [ ] Continue to partner with `#sig-docs-blog` for editorial review, work with shadows to ensure tech reviews are moving forward from SIGs
273+
* [ ] Connect with Release Lead to ensure theme and release logo will be ready for release blog (not required for draft)
274+
* [ ] Finalize Release Announcement blog draft and start review cycle, ensure it's ready for Docs Lead to publish on release day
275+
* [ ] Share the Release Announcement blog PR in #chairs-and-techleads channel to get technical reviews
276+
* [ ] Send release blog draft to CNCF (week 13)
277+
* [ ] Ensure first few Feature Blogs are ready to publish and that review and merge plans are in place for any still outstanding.
278+
279+
### For Lead and Shadows
280+
* [ ] TBC
281+
282+
### Status Summary / Note for Reference
283+
284+
- TBC
285+
286+
## Week 14: Getting Ready for Release
287+
As the release coming up so near, we should be done with most of the actions by the end of week 14.
288+
289+
### For Lead
290+
* [ ] Ensure the Release Announcement blog PR main write-up is merged
291+
* [ ] Continue to facilitate publication of remaining feature blogs, until all PRs are merged with the right publication date
292+
293+
### For Lead and Shadows
294+
* [ ] TBC
295+
296+
### Status Summary / Note for Reference
297+
298+
- TBC
299+
300+
## Week15: Release + Post Release Actions
301+
For v1.33, the release is planned on **Wednesday 23rd April 2025**. At this point, there shouldn't be too much that we need to handle other than last minute juggling...
302+
303+
### For Lead
304+
* [ ] Update the Release Announcement blog with the logo and release name!
305+
* [ ] Continue to facilitate publication of remaining Feature Blogs, until all PRs are merged with the right publication date
306+
* [ ] Update the Comms handbook with what you've learnt as leader (example PR: [here](https://github.com/kubernetes/sig-release/pull/2624))
307+
* [ ] Organize the slides for the CNCF release webinar, and send to the CNCF for review at least one week ahead of the scheduled date. (see example slides [here](https://docs.google.com/presentation/d/1FPeZNnvAAkj7s0Xd9A_XyD6DdcITyg8I26GLFtcx13w/edit?usp=sharing))
308+
* [ ] Close all the outstanding tickets
309+
- This ticket for tracking Comms progress
310+
- Release Highlight discussion
311+
- Post-release handbook / template update PRs
312+
- ... and any other tickets that was created
313+
314+
### For Lead and Shadows
315+
* [ ] Participate in release retro
316+
317+
### Status Summary / Note for Reference
318+
319+
- TBC
320+
321+
## Other Follow-up Actions and Notes
322+
323+
- We should make clarification on when the Feature Blog opt-in reach-outs to happen (it was a bit vague)
324+
- In the opt-in reach-out, we should consider whether Feature Blog write-up was done in the past
325+
- We should remove the duplicated Project Board view, and adjust the column and field wording
326+
- Make sure all the templates use the consistent KEP referencing of something like: `[KEP-4974: Deprecate v1.Endpoints](https://kep.k8s.io/4974)`
327+
- Document the version should be "v" prefixed
328+
- Update the blog status field to prefix with some numbers (the current "ready for review", "review in progress", "ready to publish" are all so similar and hard to see which one's which...)
329+
- When getting the placeholder blog PRs for Feature Blogs, we will need to get the KEP authors to come back to us in the KEP. There were a few blogs I only caught by going through the list of blog PRs, and it was quite manual.
330+
331+
## Old Updates
332+
333+
<!-- By moving the latest updates from the top of the issue down here, you can keep the timeline of updates in a single view. This is not necessary, but could be useful.-->
334+
335+
As of XX Jan (week 1):
336+
- Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

0 commit comments

Comments
 (0)