|
| 1 | +# Multichannel communications |
| 2 | + |
| 3 | +The goal of this is to provide a clearer way for community members to share and consume Kubernetes information. |
| 4 | + |
| 5 | +## Motive |
| 6 | + |
| 7 | +Our motive is as follows: |
| 8 | + |
| 9 | +* Provide all Kubernetes contributors with a dependable experience of communication to and from the project |
| 10 | +* Find ways of adding our human touch to potentially overwhelming quantities of information |
| 11 | +* Provide clear expectations on what’s important, urgent, or otherwise |
| 12 | +* Build process like we build Kubernetes, so that our contributors understands it, and it works well at scale |
| 13 | + |
| 14 | +## Outbound and inbound communications |
| 15 | + |
| 16 | +All outbound communications will have a single source of truth in [email protected]. |
| 17 | + |
| 18 | +Justification for this canonical location: |
| 19 | + |
| 20 | +* Per 2018 and 2019 survey results, it has grown in popularity as the one place to check for contributor news |
| 21 | +* Highlighted in the contributor guide, SIG READMEs, governance documentation, and many other places |
| 22 | + |
| 23 | +All other communication channels will point to that canonical location because we want to: |
| 24 | + |
| 25 | +* Avoid having many places with partial information |
| 26 | +* Avoid community member's needing to follow multiple places |
| 27 | +* Avoid confusion on where to get the right information |
| 28 | +* Create an easier process for information sharing |
| 29 | + |
| 30 | +## Mapping Type to Tier |
| 31 | + |
| 32 | +We have identified four (4) different tiers of information: |
| 33 | + |
| 34 | +* **Action Required** |
| 35 | + * Participation is critical to the Kubernetes project and has a firm due date |
| 36 | + * Example 1: The Contributor Survey responses are due by $date |
| 37 | + * Example 2: Code freeze is at $date, get your code in! |
| 38 | + * Other release information should go through the release team |
| 39 | +* **Priority Information** |
| 40 | + * Critical information to productive participation and community sustainability |
| 41 | + * Example 1: Updates on an upcoming steering committee election |
| 42 | + * Example 2: Changes in workflows, issue triaging, etc |
| 43 | +* **Feedback Appreciated** |
| 44 | + * When participation is helpful, but not required by everyone in order to be successful |
| 45 | + * Example: Kubernetes Enhancement Proposals (KEPs) |
| 46 | +* **In case you missed it (ICYMI)** |
| 47 | + * Information that is not urgent or priority, but will be interesting to others and worthwhile to highlight |
| 48 | + * Example: The monthly community & mentors meeting schedule |
| 49 | + |
| 50 | +Based on these tiers, communication will flow through different channels and may be repeated as necessary. |
| 51 | + |
| 52 | +## Channels of communication |
| 53 | + |
| 54 | +These channels will be used for written communication and tips for using them effectively: |
| 55 | + |
| 56 | + |
| 57 | + * Single source of truth |
| 58 | + * Make sure you're not burying the lead, action items should be clearly stated |
| 59 | +* Slack |
| 60 | + * Short blurb in related channels (see below) about the information on k-dev, linking to the canonical post |
| 61 | +* Discourse |
| 62 | + * Short blurb in the related category about the information on k-dev, linking to the canonical post |
| 63 | +* Twitter |
| 64 | + * Fire hose of information in 280 characters or fewer; items can be covered more than once |
| 65 | + |
| 66 | +## Slack channels to be used |
| 67 | + |
| 68 | +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: |
| 69 | + |
| 70 | +* #contributor-summit |
| 71 | +* #meet-our-contributors |
| 72 | +* #chairs-and-techleads |
| 73 | + |
| 74 | +Regional channels: |
| 75 | + |
| 76 | +* emea-dev (EMEA) |
| 77 | +* in-dev (India) |
| 78 | +* jp-dev (Japan) |
| 79 | +* cn-dev (China) |
| 80 | +* kr-dev (Korea) |
| 81 | +* aus-nz-dev (Australia & New Zealand) |
| 82 | + |
| 83 | +To find SIG-specific channels, check the Contact column in the [SIG list](https://github.com/kubernetes/community/blob/master/sig-list.md) |
| 84 | + |
| 85 | +## Questions? |
| 86 | + |
| 87 | +Have a question about what's written here or something else? Reach out to the [marketing team](README.md)! |
0 commit comments