summaryrefslogtreecommitdiff
path: root/communication
diff options
context:
space:
mode:
authorMatt Broberg <matt@opensource.com>2021-09-03 12:03:35 -0500
committerGitHub <noreply@github.com>2021-09-03 12:03:35 -0500
commitd92edf9ba1c5f98adfd9d7e246cb8069bb2fbe6e (patch)
tree4d48454f08309cbbc17f5e75bac8dbf2e5709816 /communication
parent0f378954cb387ff4d346153a68ac7458cf484b7d (diff)
parentc4ae02738c59065b12335de0c551887d209663c3 (diff)
Merge branch 'master' into mkt-update
Diffstat (limited to 'communication')
-rw-r--r--communication/marketing-team/role-handbooks/storytellers.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md
index 1d0c330f..49433f60 100644
--- a/communication/marketing-team/role-handbooks/storytellers.md
+++ b/communication/marketing-team/role-handbooks/storytellers.md
@@ -14,6 +14,51 @@ Storytelling is welcome in any medium that can be supported by the Upstream Mark
Storytellers are constantly building new ways to share, and these resources are gathered in the [storytelling resources folder].
+### Upstream Marketing Process
+
+#### Idea Paths
+
+There are multiple ways to successfully contribute a Kubernetes blog post. Here are some of the common paths to help you do so:
+
+**To start:**
+
+* Open a [Contributor Comms Requests issue](https://github.com/kubernetes/community/issues) to share your blog idea, or attend an [Upstream Marketing team](https://github.com/kubernetes/community/tree/master/communication/marketing-team) meeting to discuss it ahead of time
+
+**To write:**
+
+* Create an initial draft -- it is always easier to work from some written down ideas than to do so from scratch
+ * A draft can be written in:
+ * Google Docs or
+ * Markdown (and shared via [Gist](https://gist.github.com/) or [HackMD](https://hackmd.io/))
+* Connect with a storyteller -- if you reach out to Upstream Marketing, you will be paired with someone to help you through writing, editing, and getting your article published
+ * Discussion happens via GitHub issue or through working group meetings
+* This includes working with Upstream Marketing team to polish, and format your blog post
+ * There is not a single canonical format for documents, but we do have [guidelines for effective articles](https://github.com/kubernetes/community/blob/master/communication/marketing-team/blog-guidelines.md#how-to-write-an-effective-blog)
+ * There are further technical considerations by the [Blog team](https://github.com/kubernetes/community/blob/4026287dc3a2d16762353b62ca2fe4b80682960a/sig-docs/blog-subproject/README.md#submit-a-post)
+
+When it's ready, submit the blog post:
+
+* Go to the `kubernetes/website` repository
+* Open a PR with your added blog post
+ * If you need help with this process, Upstream Marketing will look to pair you with someone for PR and shepherd it through the review cycle
+
+Or if you already have everything you think you need you can:
+
+* Go to the `kubernetes/website` repo and send a PR
+* There's a Kubernetes blog team that will walk you through [the process](https://kubernetes.io/docs/contribute/new-content/blogs-case-studies/)
+
+### Tips
+
+Converting a Google Doc to markdown? Here is a helpful way to do so:
+
+* go to: https://discuss.kubernetes.io/
+* Open a new topic
+* Paste the Google Doc into new topic window
+ * Discourse will automatically convert it to markdown 🎉
+* Now you can copy the markdown text, with all its original formatting, and paste it into your blog post file (this will often be a text file you are editing on your computer from a text editor like VS Code)
+* Be sure to add the syntax required at the top of the blog post (see links above)
+* Now you are ready to submit it as a PR
+
## Minimum Skills and Requirements
- Have a passion for telling stories, technical writing, journalism, and painting pictures with words