Add multichannel communications doc

Signed-off-by: Jonas Rosland <jrosland@vmware.com>
This commit is contained in:
Jonas Rosland 2020-04-03 11:59:32 -04:00 committed by jonasrosland
parent b9c627b9b8
commit 96be194360
1 changed files with 87 additions and 0 deletions

View File

@ -0,0 +1,87 @@
# Multichannel communications
The goal of this is to provide a clearer way for community members to share and consume Kubernetes information.
## Motive
Our motive is as follows:
* Provide all Kubernetes contributors with a dependable experience of communication to and from the project
* Find ways of adding our human touch to potentially overwhelming quantities of information
* Provide clear expectations on whats important, urgent, or otherwise
* Build process like we build Kubernetes, so that our contributors understands it, and it works well at scale
## Outbound and inbound communications
All outbound communications will have a single source of truth in kubernetes-dev@googlegroups.com.
Justification for this canonical location:
* Per 2018 and 2019 survey results, it has grown in popularity as the one place to check for contributor news
* Highlighted in the contributor guide, SIG READMEs, governance documentation, and many other places
All other communication channels will point to that canonical location because we want to:
* Avoid having many places with partial information
* Avoid community member's needing to follow multiple places
* Avoid confusion on where to get the right information
* Create an easier process for information sharing
## Mapping Type to Tier
We have identified four (4) different tiers of information:
* **Action Required**
* Participation is critical to the Kubernetes project and has a firm due date
* Example 1: The Contributor Survey responses are due by $date
* Example 2: Code freeze is at $date, get your code in!
* Other release information should go through the release team
* **Priority Information**
* Critical information to productive participation and community sustainability
* Example 1: Updates on an upcoming steering committee election
* Example 2: Changes in workflows, issue triaging, etc
* **Feedback Appreciated**
* When participation is helpful, but not required by everyone in order to be successful
* Example: Kubernetes Enhancement Proposals (KEPs)
* **In case you missed it (ICYMI)**
* Information that is not urgent or priority, but will be interesting to others and worthwhile to highlight
* Example: The monthly community & mentors meeting schedule
Based on these tiers, communication will flow through different channels and may be repeated as necessary.
## Channels of communication
These channels will be used for written communication and tips for using them effectively:
* kubernetes-dev@googlegroups.com
* Single source of truth
* Make sure you're not burying the lead, action items should be clearly stated
* Slack
* Short blurb in related channels (see below) about the information on k-dev, linking to the canonical post
* Discourse
* Short blurb in the related category about the information on k-dev, linking to the canonical post
* Twitter
* Fire hose of information in 280 characters or fewer; items can be covered more than once
## Slack channels to be used
As Slack is a massive workspace for us it can sometimes be hard to know exactly where to put information. Here is the current list of contributor-focused channsl that we will post information to:
* #contributor-summit
* #meet-our-contributors
* #chairs-and-techleads
Regional channels:
* emea-dev (EMEA)
* in-dev (India)
* jp-dev (Japan)
* cn-dev (China)
* kr-dev (Korea)
* aus-nz-dev (Australia & New Zealand)
To find SIG-specific channels, check the Contact column in the [SIG list](https://github.com/kubernetes/community/blob/master/sig-list.md)
## Questions?
Have a question about what's written here or something else? Reach out to the [marketing team](README.md)!