summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--communication/marketing-team/role-handbooks/Comms-Tech-Lead.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/communication/marketing-team/role-handbooks/Comms-Tech-Lead.md b/communication/marketing-team/role-handbooks/Comms-Tech-Lead.md
new file mode 100644
index 00000000..3a5605de
--- /dev/null
+++ b/communication/marketing-team/role-handbooks/Comms-Tech-Lead.md
@@ -0,0 +1,55 @@
+# Comms Tech Lead Role Handbook
+
+## Overview
+
+This handbook outlines expectations and responsibilities for Tech Leads as well as Contributor Comms team members who wish to contribute to technical efforts.
+
+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).
+
+[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.
+
+Along with contributor-site there exist two automation tools that help:
+1. To create tweets (k8scontributors) via GitHub actions (see: [workflow](https://github.com/kubernetes-sigs/contributor-tweets/blob/main/.github/workflows/main.yml))
+2. To broadcasts messages across multiple slack channels (see: [slack-bot](https://github.com/kubernetes-sigs/slack-infra/tree/main/slack-post-message))
+
+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.
+
+## Minimum Skills and Requirements
+
+- Are a member of the [Kubernetes GitHub Org]
+- Good knowledge of Node.js, Hugo(docsy theme and frontmatter)
+- Have a basic experience in Go (for Slack bot)
+- Have a good understanding of Github actions
+- Available to either attend regular Contributor Comms meetings or collaborate asynchronously via the #sig-contribex-comms channel in the Kubernetes Slack
+
+### Expected Time Investment
+
+Team leads: 4-5 hours per week.
+Team members: 2-3 hours per week.
+
+## General Expectations
+
+- Be welcoming, be yourself
+- 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
+- Have an understanding of what an issue is about and able to triage them, or know who to contact to determine the required information
+- Coordinate work to fix any issues in automation tools to ensure valid tweet requests are fulfilled
+- Train new leads
+
+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.
+
+## Associates Overview (Shadow)
+
+Team members who wish to become technical leads shadow should express this desire to the current lead.
+
+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:
+
+* General familiarity with our repositories and automation tools
+* Willingness and ability to follow up with contributors about issues, on Github, Slack, and email, as appropriate
+* Ability to file well-crafted Kubernetes issues, including labeling and prow commands
+* General knowledge of our SIG system and SIGs' areas of responsibility or knowing who to contact to determine the required information
+
+Additionally, the following qualifications make a candidate more suitable for the technical team, but are not requirements:
+
+* Prior involvement with the Contributor Comms team and the contributor experience team
+* Experience with Github actions and Github workflow
+* A basic understanding of Golang