Add multichannel communications doc
Signed-off-by: Jonas Rosland <jrosland@vmware.com>
This commit is contained in:
parent
b9c627b9b8
commit
96be194360
|
|
@ -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 what’s 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)!
|
||||
Loading…
Reference in New Issue