|
| 1 | +# Comms Tech Lead Role Handbook |
| 2 | + |
| 3 | +## Overview |
| 4 | + |
| 5 | +This handbook outlines expectations and responsibilities for Tech Leads as well as Contributor Comms team members who wish to contribute to technical efforts. |
| 6 | + |
| 7 | +Tech leads' contributions further the Contributor Comms team's efforts to communicate contributors' stories by resolving technical issues and decisions around [contributor-site](https://www.kubernetes.dev/), social media automation tools [kubernetes-sigs/contributor-tweets](https://github.com/kubernetes-sigs/contributor-tweets), and [slack-bot](https://github.com/kubernetes-sigs/slack-infra/tree/main/slack-post-message). |
| 8 | + |
| 9 | +[contributor-site](https://www.kubernetes.dev/) is a one-stop for Kubernetes contributor content and news. It brings important documentation scattered throughout the project into one central location. |
| 10 | + |
| 11 | +Along with contributor-site there exist two automation tools that help: |
| 12 | +1. To create tweets (k8scontributors) via GitHub actions (see: [workflow](https://github.com/kubernetes-sigs/contributor-tweets/blob/main/.github/workflows/main.yml)) |
| 13 | +2. To broadcasts messages across multiple slack channels (see: [slack-bot](https://github.com/kubernetes-sigs/slack-infra/tree/main/slack-post-message)) |
| 14 | + |
| 15 | +The [contributor-tweets repo](https://github.com/kubernetes-sigs/contributor-tweets) utilizes open source Github action [twitter-together](https://github.com/gr2m/twitter-together) project to automate tweet approval from an issue. |
| 16 | + |
| 17 | +## Minimum Skills and Requirements |
| 18 | + |
| 19 | +- Are a member of the [Kubernetes GitHub Org] |
| 20 | +- Good knowledge of Node.js, Hugo(docsy theme and frontmatter) |
| 21 | +- Have a basic experience in Go (for Slack bot) |
| 22 | +- Have a good understanding of Github actions |
| 23 | +- Available to either attend regular Contributor Comms meetings or collaborate asynchronously via the #sig-contribex-comms channel in the Kubernetes Slack |
| 24 | + |
| 25 | +### Expected Time Investment |
| 26 | + |
| 27 | +Team leads: 4-5 hours per week. |
| 28 | +Team members: 2-3 hours per week. |
| 29 | + |
| 30 | +## General Expectations |
| 31 | + |
| 32 | +- Be welcoming, be yourself |
| 33 | +- Take ownership of an issue and submit a PR for repositories like (especially if it's quick or relates to work you're already doing) Contributor-site, tweets, and, slack bot |
| 34 | +- Have an understanding of what an issue is about and able to triage them, or know who to contact to determine the required information |
| 35 | +- Coordinate work to fix any issues in automation tools to ensure valid tweet requests are fulfilled |
| 36 | +- Train new leads |
| 37 | + |
| 38 | +Team members will be expected to keep an eye out for news or issues related to slack bot or Github automation. Common sources of such announcements are the k-dev mailing list and the #contributor-comms channel on Slack. |
| 39 | + |
| 40 | +## Associates Overview (Shadow) |
| 41 | + |
| 42 | +Team members who wish to become technical leads shadow should express this desire to the current lead. |
| 43 | + |
| 44 | +Leads should work with shadows to understand their capacity to take on the needs of the lead role and work with the shadow on a plan for them to take on responsibility including: |
| 45 | + |
| 46 | +* General familiarity with our repositories and automation tools |
| 47 | +* Willingness and ability to follow up with contributors about issues, on Github, Slack, and email, as appropriate |
| 48 | +* Ability to file well-crafted Kubernetes issues, including labeling and prow commands |
| 49 | +* General knowledge of our SIG system and SIGs' areas of responsibility or knowing who to contact to determine the required information |
| 50 | + |
| 51 | +Additionally, the following qualifications make a candidate more suitable for the technical team, but are not requirements: |
| 52 | + |
| 53 | +* Prior involvement with the Contributor Comms team and the contributor experience team |
| 54 | +* Experience with Github actions and Github workflow |
| 55 | +* A basic understanding of Golang |
0 commit comments