Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update KCS Comms Team Handbook #7961

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Conversation

kaslin
Copy link
Contributor

@kaslin kaslin commented Jul 1, 2024

Updating requirements, tasks, and descriptions for all roles on the KCS Comms team.

@k8s-ci-robot k8s-ci-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jul 1, 2024
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kaslin

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. approved Indicates a PR has been approved by an approver from all required OWNERS files. labels Jul 1, 2024
@kaslin
Copy link
Contributor Author

kaslin commented Jul 1, 2024

Holding for shadow reviews

/hold

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jul 1, 2024
Co-authored-by: Sean McGinnis <[email protected]>
@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 2, 2024
@kaslin
Copy link
Contributor Author

kaslin commented Jul 2, 2024

Good catch, thank you @stmcginnis!

@stmcginnis
Copy link
Contributor

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 2, 2024
- Always consider your intended and actual audience! When a message is only applicable to org members (which is pretty much - everything for the contributor summit), state that clearly!


### Email Tips and rules
Copy link
Member

@rayandas rayandas Jul 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Email Tips and Rules


### Social Media Rules
- Send KCS comms to k8scontributors accounts on whatever platforms they exist on. At time of writing, that’s “X” and Mastodon. Social media should be sent only to contributor-facing accounts.
- Kubernetesio on X and the Kubernetes Linkedin accounts should not be used because their audiences include end users and the general public..
Copy link
Member

@rayandas rayandas Jul 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is an extra dot at the end.

- NOTE: A sender’s first email to a mailing list will get stuck in the moderation queue. Include around a day in the delivery estimate to account for the time a sender’s first email will spend in the moderation queue. Shadows & Volunteers should plan to send their first email to a given mailing list (leads, dev, etc) early in the day on the day it’s due. (per the timezone of the location where the summit will be held).
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
- An email should be ready for review around 3 or more days before it needs to be sent.
- Send a message to the KCS Comms group dm (this is usually a dm, not a channel) on the #summit-staff channel in Slack when an email is ready for review, and preferably 1 day before it goes out.
Copy link
Member

@rayandas rayandas Jul 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'DM' instead of 'dm'

@sandipanpanda
Copy link
Member

Overall LGTM. Thanks!
/lgtm

Copy link
Member

@ArvindParekh ArvindParekh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some comments. Looks good otherwise! Thank you!

* A KCS Comms Shadow must either have, or plan to pursue, [Kubernetes Org Membership].
* Commit to contributing to the KCS Staff team for multiple cycles.

## Tasks
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Tasks
### Tasks

- Review the Contributor Comms team’s Social Media Guidelines.
- All social media should have at least 1 review, preferably by a shadow. A review by a social media approver is a given.
- Generally, social media should be ready for review at least 1 day before it needs to be sent.
- Generally, an email should be ready for review around 3 or more days before it needs to be sent.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Generally, an email should be ready for review around 3 or more days before it needs to be sent.

Should we leave this line out about email reviews from this section as it should be (and is) covered in the section of Email Tips and Rules?

- Generally, an email should be ready for review around 3 or more days before it needs to be sent.
- If any shadow does not have Buffer access, let the KCS Comms lead know.
- Always consider your intended and actual audience! When a message is only applicable to org members (which is pretty much - everything for the contributor summit), state that clearly!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

(nit - an extra line) Not sure if it'd impact the final markdown version so pointing it out just in case :)

- NOTE: A sender’s first email to a mailing list will get stuck in the moderation queue. Include around a day in the delivery estimate to account for the time a sender’s first email will spend in the moderation queue. Shadows & Volunteers should plan to send their first email to a given mailing list (leads, dev, etc) early in the day on the day it’s due. (per the timezone of the location where the summit will be held).
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
- An email should be ready for review around 3 or more days before it needs to be sent.
- Send a message to the KCS Comms group dm (this is usually a dm, not a channel) on the #summit-staff channel in Slack when an email is ready for review, and preferably 1 day before it goes out.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Send a message to the KCS Comms group dm (this is usually a dm, not a channel) on the #summit-staff channel in Slack when an email is ready for review, and preferably 1 day before it goes out.
- Send a message to the KCS Comms group dm (this is usually a dm, not a channel) and on the #summit-staff channel in Slack when an email is ready for review, and preferably 1 day before it goes out.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Announce bot?


As Communications Lead, you are responsible for the overall communications
before, during, and after the event. The role also includes ensuring all non-technical content (web, mail,
physical prints) is correct and informative, and supporting the other roles
(registration, content) as needed.

A Comms Lead should plan to attend their KCS event in-person. Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A Comms Lead should plan to attend their KCS event in-person. Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact.
A Comms Lead should plan to attend their KCS event in-person. A Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur during the event. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact.

Onsite was repeated thrice in the same sentence.

- Manage online presence of the website, alongside the social media strategy
- Recruit a website lead to handle all updates to the website
- Consider ensuring website reviewers/approvers are on the team to merge upstream changes
- Provide updates on social media, mailing lists, and Slack before, during, and after the event
- After-event communications will include a post-event survey, created by SIG ContribEx leads
- Work alongside the CNCF Events Team to coordinate communications efforts
- Assist with deck content for curated talks and/or other purposes
- Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite.
- A Comms lead acts as the contact person for any onsite communications, such as messaging about room or registration changes that may occur during the event.


This document defines communications activities needed to run a
Contributor Summit.
Kubernetes Contributor Summit (KCS). The Comms Team consists of 1-2 lead(s), shadows, volunteers, at least 1 emeritus lead, and a Website Manager.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we want to use The Communications aka Comms Team here so that everyone is clear or what the Comms phrase means?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is for the comms team for contributor summits. Yes, it's slightly confusing.

- [KCS Comms Lead Overview](#kcs-comms-lead-overview)
- [Shadow to the KCS Comms Lead Role](#shadow-to-the-kcs-comms-lead-role)
- [KCS Comms Volunteer Overview](#kcs-comms-volunteer-overview)
- [KCS Website Manager Overview](#kcs-website-manager-overview)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This anchor KCS Website Manager Overview isn't working.

- [Shadow to the KCS Comms Lead Role](#shadow-to-the-kcs-comms-lead-role)
- [KCS Comms Volunteer Overview](#kcs-comms-volunteer-overview)
- [KCS Website Manager Overview](#kcs-website-manager-overview)
- [Emeritus KCS Comms Lead Overview](#kcs-website-manager-overview)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This anchor Emeritus KCS Comms Lead Overview isn't working.

- Volunteer requirements
- Associated activities such as comms and meeting updates
- Update the included rough comms timelines
- Create a doc for comms drafts using the [KCS Comms Draft Doc Template]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to mention about Award / logo designs?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be owned by the Design lead. Which does not currently exist, but should in the future. I'll need to create a new role handbook.


## Shadow to the KCS Comms Lead Role

Shadows are expected to serve as KCS Comms Leads in a future cycle. During their shadowing cycle(s), Shadows will work closely with the KCS Comms Lead to learn both how to run the KCS Comms team and how to create comms themselves. By signing up to shadow, you are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). A Shadow candidate must either have [Kubernetes Org Membership] or be planning to pursue org membership.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Shadows are expected to serve as KCS Comms Leads in a future cycle. During their shadowing cycle(s), Shadows will work closely with the KCS Comms Lead to learn both how to run the KCS Comms team and how to create comms themselves. By signing up to shadow, you are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). A Shadow candidate must either have [Kubernetes Org Membership] or be planning to pursue org membership.
Shadows are expected to serve as KCS Comms Leads in a future cycle. During their shadowing cycle(s), Shadows will work closely with the KCS Comms Lead to learn both how to run the KCS Comms team and how to create comms themselves. By signing up to be a shadow, you are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). A Shadow candidate must either have [Kubernetes Org Membership] or be planning to pursue org membership.

- [Skills and Qualifications](#skills-and-qualifications)
- [Responsibilities](#responsibilities)
- [Communication Channels and Property Access](#communication-channels-and-property-access)
Comms Leads are responsible for leading the comms team, training shadows, and ensuring all comms activities are planned, prioritized, and completed successfully. They are committed to run the comms team for the current cycle and advise as Emeritus KCS Comms Lead in the following comms cycle (2 cycles, 1 year). Must have [Kubernetes Org Membership]. Expected to attend in-person.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 cycles, 1 year

Could we say 2 cycles per year? Is that accurate with India being in the mix now too or is someone else running with it?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, cycle, I wasn't clear if that meant EU and US but I'm assuming so.

- [Communication Channels and Property Access](#communication-channels-and-property-access)
Comms Leads are responsible for leading the comms team, training shadows, and ensuring all comms activities are planned, prioritized, and completed successfully. They are committed to run the comms team for the current cycle and advise as Emeritus KCS Comms Lead in the following comms cycle (2 cycles, 1 year). Must have [Kubernetes Org Membership]. Expected to attend in-person.

Shadows will learn both how to do comms and how to run the KCS Comms team, as directed by the Comms Lead. They are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). Must either have [Kubernetes Org Membership] or be planning to pursue org membership.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would change "persue" to be, "on their way towards org membership"

I don't want to exclude anyone, but at the same time a shadow that's not an org member; feels like that'd be harder than expected. Have we ever granted org membership to someone that is helping with the current comms cycle? cc @jberkus

Copy link
Contributor

@jberkus jberkus Jul 11, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We've given people a bump, but not if KCS Comms was their very first contribution. However, since Comms is a role that doesn't require attendance at the KCS itself, it's completely reasonable for someone to pursue KCS Comms shadow as their contributions that will get them org membership after the KCS.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of the comms shadows this cycle got their org membership during the cycle.


Shadows will learn both how to do comms and how to run the KCS Comms team, as directed by the Comms Lead. They are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). Must either have [Kubernetes Org Membership] or be planning to pursue org membership.

Volunteers are expected to assist with comms during the current KCS cycle, as directed by the lead. Volunteers do not need to have or be pursuing [Kubernetes Org Membership].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Volunteers are GREAT!

But, for KCS Comms is it okay to bring in someone completely new to the project to help? What would that work look like? I think answering these two questions will need to be in the doc (an FAQ or something like that is an option too).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure, why not? It's a pretty good first contribution task.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1. One problem with comms is just the sheer volume. If someone wanted to pop in to help with getting some drafts written, but didn't want to commit to being on a leadership path, I would still welcome the help.


Volunteers are expected to assist with comms during the current KCS cycle, as directed by the lead. Volunteers do not need to have or be pursuing [Kubernetes Org Membership].

An emeritus comms lead is a past lead who provides mentorship to the current comms lead. Should have [Kubernetes Org Membership].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should to Must

If someone is an emeritus comms lead, I would hope that we'd grant org membership as soon as we could. But, what examples were you thinking of here?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So the requirements below says the "KCS Comms Lead must have [Kubernetes Org Membership]. (They should not plan to pursue membership during the cycle.)"

Then we definitely update this language for org membership as a requirement.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we could have the case, someone lost the membership because of inactivity and came back and picked up by supporting. But i don't know if this ever happened

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was thinking of a case like Mario is describing here. Like I don't know if Paris' org membership is still active, but imagine it wasn't and we needed help and she volunteered to serve as an emeritus advisor. I'd still accept that. Unlikely. But possible.

## Overview
## KCS Comms Lead Overview

A KCS Comms Lead should plan to be involved with KCS planning for at least a year (2 KCS events), first as lead (for 1 or more events), and then as an emeritus mentor to the succeeding Comms lead (for 1 or more events). The workload of being an Emeritus Comms Lead is light, but they are still actively involved.
Copy link
Contributor

@chris-short chris-short Jul 11, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 KCS events

Events or cycles; let's keep the language consistent. I'd prefer events over cycles as that doesn't introduce a new term.


A KCS Comms Lead should plan to be involved with KCS planning for at least a year (2 KCS events), first as lead (for 1 or more events), and then as an emeritus mentor to the succeeding Comms lead (for 1 or more events). The workload of being an Emeritus Comms Lead is light, but they are still actively involved.

A KCS Comms Lead holds that role from the beginning of planning for a specific KCS event until all activities for that event are completed, including post-event activities such as event retros and updating the handbook (this doc). This timeframe is the "cycle" for that KCS event.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we stick with the cycle term then this paragraph really needs to be before the first mention of a cycle.

This section acts as a checklist for activities the KCS Comms Lead is likely to do each cycle.

- Create Slack DM with Comms team (lead, shadows, volunteers)
- Create a doc using the [KCS Comms Team Plan Template] & put it in the relevant KCS folder
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we link to the Comms folder here?


### Requirements
* Review this document.
* A KCS Comms Shadow must either have, or plan to pursue, [Kubernetes Org Membership].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like to see at least one commit before they shadow. Non-org member shadows could be asked to step into the lead role in case the Lead has to drop out for reasons outside their control.

I have no idea how to phrase that though; happy to workshop the language.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think Arvind or Sandeep had any commits before shadowing this time.

* Representing the KCS Comms team in KCS Staff meetings.
* Writing email comms as instructed by the KCS Comms Lead.
* Writing social media comms as instructed by the KCS Comms Lead.
* Reviewing comms written by other shadows, volunteers, or the lead as directed by the KCS Comms Lead
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would drop the, "as directed..." part here as I think it's a must for even the leads' work to be reviewed.


Shadows should work with the Comms Lead to ensure they are getting sufficient experience to feel comfortable taking on the KCS Comms Lead role in a future cycle after completion of a shadow cycle.

In the event a shadow is unable to complete the tasks expected of them as designated by the KCS Comms Lead, they should inform the KCS Comms Lead as early as possible, to the best of their ability. Shadows who are unable to complete the required tasks as designated by the KCS Comms Lead, will be removed from the list of shadows. Upon failure to complete a shadowing cycle, the contributor may request to become a shadow in a future cycle. Successful completion of a shadowing cycle (as determined by the KCS Comms Lead) or equivalent experience is required to become a KCS Comms Lead.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would actually bold the, "as early as possible." And maybe throw in some language that life happens and we support you in your endeavours be they here or elsewhere.

* Review this document.
* Commit to supporting KCS Comms through the current cycle

### Tasks
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the Lead allowed to delegate to a shadow to management of volunteers? I feel like we might be putting too much burden on the lead potentially.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A volunteer could just pop in to help with a single message. They're not training for leadership, so they don't need a path or work assigned to them. They can contribute or not. We haven't had anyone volunteer yet at this point, so hard to say exactly what a volunteer might want out of the experience or how much management they might need.

* Working with the Comms Lead and Contributor Comms Subproject to get access to tooling for posting on Kubernetes Contributor-focused social media channels.
* Writing email comms as instructed by the KCS Comms Lead.
* Writing social media comms as instructed by the KCS Comms Lead.
* [optional] Reviewing comms written by other volunteers, shadows, or the lead as directed by the KCS Comms Lead
Copy link
Contributor

@chris-short chris-short Jul 11, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would change optional to encouraged

* Writing social media comms as instructed by the KCS Comms Lead.
* [optional] Reviewing comms written by other volunteers, shadows, or the lead as directed by the KCS Comms Lead

## KCS Website Manager
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This new role is a GREAT idea.

I think it's possible that non-KCS planning members could help here too (case in point, folks with Hugo and/or Docsy experience).

Might even be worth it to say they can lean on the Contributor Comms team for assistance too, as needed.

- Basic familiarity with the [Markdown](https://www.markdownguide.org/) markup language

### Tasks
During the course of their KCS cycle as a website manager, KCS Website Managers are expected to complete tasks including but not limited to:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can there be multiple website managers (the term webmaster from the 90s did pop into my head, but that's only because I was one in high school).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Theoretically, yes, but in practice we've struggled to recruit even one.

## Comms Rules and Guidelines

### Social Media Rules
- Send KCS comms to k8scontributors accounts on whatever platforms they exist on. At time of writing, that’s “X” and Mastodon. Social media should be sent only to contributor-facing accounts.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At time of writing, that’s “X” and Mastodon. Social media should be sent only to contributor-facing accounts.

I would just link to the contributor comms social media directory and stay away from specifics on which network is in use.

### Social Media Rules
- Send KCS comms to k8scontributors accounts on whatever platforms they exist on. At time of writing, that’s “X” and Mastodon. Social media should be sent only to contributor-facing accounts.
- Kubernetesio on X and the Kubernetes Linkedin accounts should not be used because their audiences include end users and the general public..
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
Copy link
Contributor

@chris-short chris-short Jul 11, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would again stay away from specifics here and replace it with a more general guideline of keeping the comms doc consistent. As screens increase pixel density, 11 pt might not be big enough.

- Send KCS comms to k8scontributors accounts on whatever platforms they exist on. At time of writing, that’s “X” and Mastodon. Social media should be sent only to contributor-facing accounts.
- Kubernetesio on X and the Kubernetes Linkedin accounts should not be used because their audiences include end users and the general public..
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
- If you are scheduling comms to go out at a specific time, make sure that time is aligned with the timezone the event will be held in.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be a top level thing not buried on line 166.

- Kubernetesio on X and the Kubernetes Linkedin accounts should not be used because their audiences include end users and the general public..
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
- If you are scheduling comms to go out at a specific time, make sure that time is aligned with the timezone the event will be held in.
- Link to k8s.dev/events and subpages, or email messages, wherever possible. Avoid sharing links to contributor-specific links such as Registration, CFP, and GitHub Issues.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, top level guidance for the whole team.

- If you are scheduling comms to go out at a specific time, make sure that time is aligned with the timezone the event will be held in.
- Link to k8s.dev/events and subpages, or email messages, wherever possible. Avoid sharing links to contributor-specific links such as Registration, CFP, and GitHub Issues.
- While our Social Media presence is largely targeted at contributors, all social media posts are public. As such, we should avoid sharing links which could cause unwanted spam/interactions.
- Review the Contributor Comms team’s Social Media Guidelines.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A link here would be helpful.


### Email Tips and rules
- NOTE: A sender’s first email to a mailing list will get stuck in the moderation queue. Include around a day in the delivery estimate to account for the time a sender’s first email will spend in the moderation queue. Shadows & Volunteers should plan to send their first email to a given mailing list (leads, dev, etc) early in the day on the day it’s due. (per the timezone of the location where the summit will be held).
- Make sure comms are formatted in Arial, 11pt, with single line spacing before copying into the target platform. This will ensure that the text looks consistent wherever it is posted.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since it's mentioned twice, what's the problem we're trying to prevent here?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Regarding the moderation queue, we added this information to the comms document after my first email got stuck in the queue. At the time, we didn't realize this and thought the email hadn't been sent. It took some time to reach out to the leads and ask them to approve the email, so we mentioned this to account for the delay during a shadow's first email.

On the formatting specifics, we included these guidelines because, when my first email was sent out, it looked fine in the document. However, after sending, we noticed inconsistencies in styling. This happened because I drafted the email in my personal doc and copied it over to the comms doc, which was initially fine, but adding extra information directly into the draft in the comms doc led to formatting issues. These were not very noticeable in the Google Doc, and I missed them. Therefore, we thought it would be helpful to specify formatting details (Arial, 11pt, single line spacing) to ensure consistency in all communications.

However, I agree that we could replace these specifics with a more general guideline and perhaps use this example to illustrate the point.


Volunteers are expected to assist with comms during the current KCS cycle, as directed by the lead. Volunteers do not need to have or be pursuing [Kubernetes Org Membership].

An emeritus comms lead is a past lead who provides mentorship to the current comms lead. Should have [Kubernetes Org Membership].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we could have the case, someone lost the membership because of inactivity and came back and picked up by supporting. But i don't know if this ever happened


As Communications Lead, you are responsible for the overall communications
before, during, and after the event. The role also includes ensuring all non-technical content (web, mail,
physical prints) is correct and informative, and supporting the other roles
(registration, content) as needed.

A Comms Lead should plan to attend their KCS event in-person. Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A Comms Lead should plan to attend their KCS event in-person. Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact.
A Comms Lead should plan to attend their KCS event in-person. Onsite, a Comms lead acts as the contact person for any comms needed onsite, such as messaging about room or registration changes that may occur onsite. In the event that a KCS Comms Lead is unable to attend in-person, the lead is responsible for designating an in-person comms point of contact, that have access to the various comms channels.

The person on site need to act fast so they should have access or rights to publish

- Adding and maintaining information and pages throughout the event cycle, including:
- Registration info
- CFP & schedule info
- Social venue and registration info
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Social venue and registration info
- Social venue and registration info
- Notes folder
- Unconference informations

Copy link
Contributor Author

@kaslin kaslin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Responding to comments

- [Communication Channels and Property Access](#communication-channels-and-property-access)
Comms Leads are responsible for leading the comms team, training shadows, and ensuring all comms activities are planned, prioritized, and completed successfully. They are committed to run the comms team for the current cycle and advise as Emeritus KCS Comms Lead in the following comms cycle (2 cycles, 1 year). Must have [Kubernetes Org Membership]. Expected to attend in-person.

Shadows will learn both how to do comms and how to run the KCS Comms team, as directed by the Comms Lead. They are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). Must either have [Kubernetes Org Membership] or be planning to pursue org membership.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of the comms shadows this cycle got their org membership during the cycle.


Shadows will learn both how to do comms and how to run the KCS Comms team, as directed by the Comms Lead. They are committing to be involved with the event team for 1.5 years or 3 comms cycles (shadow, lead, and emeritus). Must either have [Kubernetes Org Membership] or be planning to pursue org membership.

Volunteers are expected to assist with comms during the current KCS cycle, as directed by the lead. Volunteers do not need to have or be pursuing [Kubernetes Org Membership].
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1. One problem with comms is just the sheer volume. If someone wanted to pop in to help with getting some drafts written, but didn't want to commit to being on a leadership path, I would still welcome the help.


Volunteers are expected to assist with comms during the current KCS cycle, as directed by the lead. Volunteers do not need to have or be pursuing [Kubernetes Org Membership].

An emeritus comms lead is a past lead who provides mentorship to the current comms lead. Should have [Kubernetes Org Membership].
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was thinking of a case like Mario is describing here. Like I don't know if Paris' org membership is still active, but imagine it wasn't and we needed help and she volunteered to serve as an emeritus advisor. I'd still accept that. Unlikely. But possible.

- Volunteer requirements
- Associated activities such as comms and meeting updates
- Update the included rough comms timelines
- Create a doc for comms drafts using the [KCS Comms Draft Doc Template]
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be owned by the Design lead. Which does not currently exist, but should in the future. I'll need to create a new role handbook.


### Requirements
* Review this document.
* A KCS Comms Shadow must either have, or plan to pursue, [Kubernetes Org Membership].
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think Arvind or Sandeep had any commits before shadowing this time.

* Review this document.
* Commit to supporting KCS Comms through the current cycle

### Tasks
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A volunteer could just pop in to help with a single message. They're not training for leadership, so they don't need a path or work assigned to them. They can contribute or not. We haven't had anyone volunteer yet at this point, so hard to say exactly what a volunteer might want out of the experience or how much management they might need.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants