The Communications Coordinator role is responsible for facilitating, empowering, and curating communication between the release team and various stakeholders including the Cloud Native Computing Foundation (CNCF), the media, contributing vendors, Kubernetes project managers, and the overall Kubernetes community at large.
Communications deliverables that come from the release process include a release blog, an optional removals and deprecations blog, facilitation of a feature blog series, scheduling of a CNCF Kubernetes release webinar as well as other speaking opportunities, and approved messaging for media. In the event the release schedule slips, the communications coordinator will ensure media opportunities through the CNCF are synchronized and that all stakeholders are kept advised of changes in timing.
Before continuing on to the Communications specific requirements listed below, please review and work through the tasks in the Release Team Onboarding Guide.
- Strong written and verbal communications skills
- A working knowledge of Kubernetes concepts
- Fundamental GitHub skills and experience with open source projects
- Enough experience with the Kubernetes release process to understand how communications milestones fit into the overall release
- Project management experience
- Existing relationships with the CNCF, relevant media personnel and outlets, Kubernetes project managers, and vendor stakeholders is helpful, but not required
- The communications lead should take the Inclusive Speaker Orientation (LFC101) training course
The Kubernetes release cycle spans 15 weeks, however it may run longer. The typical workload for the communications team is very light during the first few weeks of the release cycle. In the later weeks, the workload can become heavy, and will continue a few weeks after the release.
The expected time investment for both leads and shadows are as follows:
-
30 minutes to 2 hours a day (depending upon week), requesting and reviewing incoming KEPs and blog PRs, working with other SIGs or the CNCF to manage the feature blog posts, and following Slack channels in order to keep pending content current.
-
1 to 5 hours a week, attending Release Team (weekly) and Burndown meetings (daily during Code Freeze)
NOTE: These are estimates and your personal experience may vary. The more time you spend working as a team and regularly communicating within your team, the better off your experience will be.
Please use the [email protected] Google Group list for external release communications (communicating with the CNCF, etc.).
The following groups should be members:
- The current release cycle's Release Team Lead & Lead Shadows
- The current release cycle's Communications Lead & Comms Shadows
- SIG Release Chairs
The list must rotated/actively managed every cycle. Submit a PR to update this document per the milestone activities described below.
There is a channel on the Kubernetes Slack workspace, #release-comms, which is used by the communications release team to coordinate their efforts. If you're on the communications team, or applying to be, then it would be advantageous to follow along with the conversations. The Communications Coordinator (often referred to as the "Comms Lead") should post a status here at a regular cadence to keep release team members and other stakeholders informed.
Throughout the release cycle, the main Communications deliverables include:
- Authoring the Kubernetes release blog. The Communications team writes the release blog, which is the official announcement of the Kubernetes release.
- Coordination and support of the feature blog series. SIGs opt-in to author feature blogs for the release. These blogs are written by technical owners, and the Communications team supports authors from the early stages through facilitating editorial and tech reviews as well as publication.
- Coordination and support of an optional Deprecations and Removals blog. Depending upon the content of a given release, it may be necessary to prepare the community for upcoming deprecations and removals. This is decided per release cycle around the time of Code Freeze.
- Scheduling press activities and the post-release webinar with the CNCF. The Communications Coordinator works with the CNCF to schedule press release activities around the release, and to schedule the release webinar (typically scheduled 3-4 weeks post-release).
The Communications Coordinator along with the Comms shadows are responsible for authoring the official Kubernetes Release blog. This blog is the official statement of release. The release blog is the primary vehicle by which the release team communicates the major themes, known issues, and other aspects of the release to the community.
Start the draft with the team around week 12, striking a balance between the enhancements being close to finalized and having enough to time author the blog and have it reviewed. Ahead of review, open a pull request on the website repository and assign the release lead and other stakeholders as reviewers.
It's up to you and your team regarding how best to do this. Typically it works well to assign sections to different team members (e.g. Major Themes, User Highlights, Ecosystem Updates, etc.) and have the lead pull it all together and manage the PR and reviews.
The release lead will drive the content for the release theme and logo.
Tracking, facilitating, and organizing the publication of the Feature Blog series is a major deliverable of the Comms team. Feature blogs are opt-in for SIGs, and authored by enhancement developers and others close to the features. It helps to work with the release lead and use the respective SIG Slack channels to remind the SIGs about opting-in to feature blogs.
The first feature blog typically goes out on release day alongside or shortly after the release blog, and then are published one-at-a-time, typically at a rate of two to three posts weekly. The Comms team establishes the publication schedule. Note that blog PRs in k/website are dated, and automation will publish future-dated entries. This enables a PR process decoupled from blog publication date.
As feature blogs are opted in, assign them to shadows and yourself for tracking and facilitation. The responsibility is to ensure the blog authors have the resources and information they need, including editorial and tech reviews once ready.
Work closely with the SIG Docs Blogs team (connecting on #sig-docs-blogs and by attending meetings), as they are typically available for editorial reviews. Share with them the feature blog schedule and updates throughout the cycle.
For tech reviews, reach out to authors and the sponsoring SIG to organize at least one tech review per blog post.
Work with SIG Contributor Experience (connecting on #sig-contribex and by attending meetings), to promote the feature blogs.
This blog is optional and will vary from release to release. Work with the rest of the release team ahead of the Code Freeze date to determine if a mid-cycle blog focused on feature deprecations and removals is warranted. If so, facilitate its creation and publication. You can create a Slack thread on #sig-release to discuss this.
If the release will deprecate important and commonly-used features (or simply a large number of features will be deprecated), consider publishing this blog. Also consider this when commonly-used features that have been deprecated are removed in a release. 'Kubernetes API and Feature Removals in 1.22' and 'Deprecated APIs Removed in 1.16' are great examples to work from.
Publication should occur ahead of the release in order to inform the community and allow for preparation time. Start the discussion mid-cycle and well ahead of Code Freeze, and target publication for Code Freeze week.
This is a light but very important component of the Communications Coordinator role. Two sets of activities need to be scheduled with the CNCF, namely press release and interview scheduling around the release day and the release webinar after the release.
You will be a liaison between the Release lead and the CNCF contacts to schedule the press briefings. Send an email to [email protected] about a month ahead of the release and coordinate between the parties to get release day press events scheduled.
To schedule the release webinar with the CNCF, start things with an email to [email protected]. You will likely use the Calendly link (below) to schedule a "live webinar". If things are tight on the schedule, CNCF will help find a spot.
The webinar is typically scheduled for 3-4 weeks after the release and is primarily presented by the Release lead and Enhancements lead. Often the Comms lead will also join the webinar. The format is open, but primarily the team walks through the enhancements in the release and gives a sneak peek of what's coming in the next release.
Refer to the slides and webinar from the 1.22 release as an example.
Note you'll need to send headshots and company/title information when you schedule the webinar and the slides should be sent for CNCF review at least one week ahead of the webinar.
This is an example of a typical release cycle and the order of how tasks will flow for Comms. Note that some tasks may take longer than their designated "release week".
| 1 | Start of release cycle |
|
| 2 |
|
|
| 3 | Production Readiness Freeze |
|
| 4 | Enhancements Freeze |
|
| 5 |
|
|
| 8 |
|
|
| 10 |
|
|
| 11 | Feature blog freeze |
|
| 12 | Code Freeze |
|
| 13 |
|
|
| 14 | Feature Blogs ready to review |
|
| 15 | Release Week |
|
| 16 | Release retrospective |
|
To support you in the creation of the release blog this outline summarize ideas for sections and gives you a template for easier release blog creation.