summaryrefslogtreecommitdiff
path: root/communication
diff options
context:
space:
mode:
authorJonas Rosland <jrosland@vmware.com>2020-04-03 11:59:32 -0400
committerjonasrosland <jrosland@vmware.com>2020-05-01 11:01:33 -0400
commit96be194360365d553bc7ea86e8d8a58d66021256 (patch)
treedb898746ebb23b8955cf6e0031055f35c7c6a0b7 /communication
parentb9c627b9b85ba06c41432360e132a54d6a5adecf (diff)
Add multichannel communications doc
Signed-off-by: Jonas Rosland <jrosland@vmware.com>
Diffstat (limited to 'communication')
-rw-r--r--communication/marketing-team/multichannel-communications.md87
1 files changed, 87 insertions, 0 deletions
diff --git a/communication/marketing-team/multichannel-communications.md b/communication/marketing-team/multichannel-communications.md
new file mode 100644
index 00000000..ac457c62
--- /dev/null
+++ b/communication/marketing-team/multichannel-communications.md
@@ -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)!