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