Skip to content

Commit 8145b14

Browse files
author
parispittman
committed
adding handbook templates
1 parent 0e56a9a commit 8145b14

File tree

6 files changed

+209
-7
lines changed

6 files changed

+209
-7
lines changed

communication/marketing-team/README.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ The Contributor Marketing Team is part of the community-management subproject in
66
to better inform the Kubernetes contributor community and highlight their work to
77
the broader ecosystem
88

9-
| Area | Handbook | Lead | Team | Notes |
10-
| --- | --- | --- | --- | --- |
11-
| Editorial | TODO | editor: @parispittman (to bootstrap)| assoc editor: @mbbroberg | |
12-
| Internal Communications | TODO | @jonasrosland | @simplytunde | |
13-
| Social Media | TODO | @chris-short | [Could be you!] (paris to help bootstrap) | |
14-
| Storytellers | TODO | liaison to sig-docs-blog team @onlydole | @celanthe, @vonguard, @boluisa, [Could be you!] | |
15-
| Designer | TODO | [Could be you!] | | help us with digital assets, infographics, contributor site |
9+
| Area & Handbook Link | Lead | Team | Notes |
10+
| --- | --- | --- | --- |
11+
| [Editorial] | editor: @parispittman (to bootstrap)| assoc editor: @mbbroberg | |
12+
| [Internal Communications] | @jonasrosland | @simplytunde | |
13+
| [Social Media] | @chris-short | @kaslin (paris to help bootstrap) | |
14+
| [Storytellers] | liaison to sig-docs-blog team @onlydole | @celanthe, @vonguard, @boluisa, @kaslin, and [Could be you!] | |
15+
| [Designer] | [Could be you!] | | help us with digital assets, infographics, contributor site |
1616

1717

1818
## Contact Us!
@@ -39,3 +39,8 @@ Let us know you are interested and if you have any questions.
3939
[charter]: ./CHARTER.md
4040
[Could be you!]: (#Could-be-you!)
4141
[Contributor Experience]: /sig-contributor-experience
42+
[Editorial]: /role-handbooks/editor.md
43+
[Internal Communications]: /role-handbooks/internal-marketing.md
44+
[Social Media]: /role-handbooks/social-media.md
45+
[Storytellers]: /role-handbooks/storytellers.md
46+
[Designer]: /role-handboos/wip-roles.md
Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
# Editor Handbook
2+
3+
## Overview
4+
5+
The Editor takes on a beacon role for the group to bring multiple functions together ensuring Kubernetes contributors have a wealth of robust content and communications.
6+
7+
### Responsibilities
8+
9+
- Develop high level marketing strategies and themes to address problem areas, challenges, and innovation/moving the project forward; expected to collaborate with Leads on their strategies for functional areas
10+
- Ensure the team has a unified voice, focus, and work within the charter scope
11+
- Research and identify new and innovative ways of delivering content that
12+
appeals to our mission
13+
- Facilitates meetings or can delegate to Associate Editor
14+
- Manage the [editorial calendar] and [marketing project] boards.
15+
- Proofreading and editing articles with our [blogging] and [ethos] in mind
16+
- Act as or facilitate conversations and workflows between all types of stakeholders:
17+
- SIG Contributor Experience
18+
- Community Group Chairs and Tech Leads
19+
- CNCF
20+
- Steering Committee
21+
- Contributors
22+
- Working with the liaison team members to manage communications and workflows
23+
between the groups
24+
- Helping to recruit other members of the team, ensuring onboarding but delegating to proper lead; fall back when no lead present is the Editor
25+
- Has the ability to modify the team charter and seeks consensus with Contributor Experience communication [OWNERS] when considering any major changes.
26+
- If time allows, market the team; blog about the team and it's progress, encourage team to blog about their work
27+
28+
### Minimum Skills and Requirements
29+
30+
Skills:
31+
- Be comfortable with general GitHub workflows. We can teach you ours but a foundation for this role is necessary. You'll be working inside of multiple repositories with different experiences and helping others on the team with troubleshooting.
32+
- Strong written and verbal skills
33+
- Be ok with saying no, but with a reason to back it up; be empathetic.
34+
- Have existing relationships with the contributor community either through other work or as an Associate Editor
35+
- Patience
36+
37+
Requirements:
38+
- Member of the [Kubernetes GitHub Org]
39+
- [Reviewer] in the marketing team folder
40+
- Shadowed under a lead in any role on the team for 6 months total (could be a combination of roles during that time period
41+
42+
43+
#### Expected Time Investment
44+
45+
- Four hours a week as a minimal target.
46+
47+
### Platforms, Tools, Access
48+
49+
Here is a checklist of items we will work to get access when you accept the role.
50+
51+
- Access to send and respond to email from [email protected]
52+
- Access to community and website repositories, all relevant calendars, and project boards
53+
- Other items listed in [team-resources.md]
54+
55+
### Duration
56+
57+
6months to 12months??
58+
//discussion point
59+
60+
## Associates Overview (Shadow)
61+
62+
The Associate Editor should be able to achieve the above list of skills by the time they will be eligible to become the lead.
63+
64+
### Expectations
65+
66+
Collaborate closely with the lead Editor toward the responsibilities outlined above. Be ready to backfill for them when they are unable to attend a meeting or represent the working group.
67+
68+
69+
70+
TODO
71+
72+
73+
74+
[editorial calendar]: https://github.com/orgs/kubernetes/projects/41
75+
[marketing project]: https://github.com/orgs/kubernetes/projects/39
76+
[team resources]: /team-resources.md
77+
[Kubernetes GitHub Org]: https://git.k8s.io/community/community-membership.md
78+
[Reviewer]: ./OWNERS
79+
[OWNERS]: /communication/OWNERS
80+
[blogging]: /blog-guidelines.md
81+
[ethos]: /CHARTER.md#ethos/vision
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Internal Communications and Marketing Handbook
2+
3+
## Overview
4+
5+
TODO
6+
7+
## Responsibilities
8+
- Working towards a more streamlined communication process within the project for different use cases
9+
- Create and maintain a one stop shop intake form/issue template/etc for contributors to get comms and marketing support
10+
- identifying communication milestones and deadlines
11+
- map out communication pipelines
12+
- promoting contributor events
13+
Events
14+
- in the events folder or one off contributor events like SIG onboarding sessions
15+
KEPs
16+
- to follow the same process as [social guidelines]
17+
- no promotion unless there is an explicit documented request
18+
19+
20+
## Minimum Skills and Requirements
21+
- Are a member of the [Kubernetes GitHub Org]
22+
- Shadowed in this role or another role on the marketing team for at least 3 months
23+
24+
25+
### Expected Time Investment
26+
27+
TODO
28+
3-5 hours a week?
29+
30+
### Platforms, Tools, and Access
31+
32+
- Needs access to send and respond to mail on [email protected]
33+
- contributor calendar
34+
- and everything listed in [team-resources.md]
35+
36+
## Associates Overview (Shadow)
37+
38+
39+
## Out of scope
40+
- release; there is a communications coordinator (can help where needed, be an advisor, or help with reach)
41+
- contributor summit; there is a role that will assume a communications function (can help where needed, be an advisor, or help with reach)
42+
- TODO
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Social Media Handbook
2+
3+
## Overview
4+
5+
TODO
6+
7+
## Minimum Skills and Requirements
8+
9+
- Are a member of the [Kubernetes GitHub Org]
10+
- Familiar with twitter by either having a personal account or managing another account (brand, oss project, employer, local nonprofit, etc)
11+
- TODO
12+
13+
### Expected Time Investment
14+
15+
TODO
16+
3-5 hours a week
17+
18+
## General Expectations
19+
20+
- Most of this information can be found in our [social guidelines]
21+
- Be welcoming, be yourself
22+
23+
24+
## Associates Overview (Shadow)
25+
26+
TODO
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Storytellers 📖 Handbook
2+
3+
## Overview
4+
5+
It's no secret that governance and technical documentation can be kind of on the boring side. And that's ok - it's not there to put on a circus but provide valuable information and get you were you need to go.
6+
7+
In this role, Storytellers are here for both! Storytellers will take us on journeys through words and visuals to help us craft...
8+
TODO add more here
9+
10+
## Workflow ⚡️
11+
12+
TODO
13+
document a short workflow here
14+
1 should be for those who are comfortable going back and forth on a PR
15+
another option should include agreeing on a *final* version in a separate
16+
collaborative doc tool and the sig-docs-liaison or Editor will start the PR
17+
process
18+
19+
## Minimum Skills and Experience
20+
- Have a passion for telling stories, technical writing, journalism, and painting pictures with words
21+
- Desire to be a Kubernetes Org Member and if not already, work your way towards membership
22+
- Comfortable with working with GitHub workflows or working in a collaborative doc tool with the Editor
23+
24+
## Expectations
25+
Anyone is welcome to contribute when they have time. The core expectation of storytelling is taking responsibility for getting the story from inception to published.
26+
27+
If you would like to be listed as a member of the team, here are the expectations:
28+
29+
1. Be prepared to write one blog a quarter and participate in edits to other articles. The time commitment is typically 5-10 hours per quarter depending on the number of blog posts in the review queue.
30+
2. Storytellers are expected to attend at least one upstream marketing team meeting a month or check-in to remain active.
31+
3. Remain non-partial: if you receive a request to write about a project, an individual, or a group of people from your employer, you should ask an impartial blogger to write it.
32+
4. As with all contribution to Kubernetes, adhere to the [code of conduct](/code-of-conduct.md), values, and principles of the project.
33+
34+
There is no shadow roles for Storytellers. If Storytellers are interested in
35+
becoming the teams sig-docs-liaison they should follow the process for the
36+
community role on the sig-docs-blog team. TODO add link here
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
# Work In Progress Roles
2+
3+
## Purpose
4+
Capture roles that we would like to have but don't have them filled for Reasons.
5+
6+
7+
## Roles
8+
1. Designer
9+
someone to help with youtube thumbnails, logos, social clips/gifs
10+
help us manage digital assets
11+
12+
2. TODO / Add one here

0 commit comments

Comments
 (0)