From b3115472a2fd7156d7e482d9c799f52eb43d3b13 Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 30 Apr 2021 11:34:28 -0400 Subject: [PATCH 1/7] Updated workflow Replaced TODO. --- .../role-handbooks/storytellers.md | 43 ++++++++++++++++--- 1 file changed, 37 insertions(+), 6 deletions(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index f4f59c2ee..b71b31714 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -9,12 +9,43 @@ TODO add more here ## Workflow ⚡️ -TODO -document a short workflow here -1 should be for those who are comfortable going back and forth on a PR -another option should include agreeing on a *final* version in a separate -collaborative doc tool and the sig-docs-liaison or Editor will start the PR -process +### Upstream Marketing Process + +#### Idea Paths + +There is no one way to get into the kubernetes blog. Below are some options: + +The Kubernetes Upstream Marketing team under ContribEx can help you tell a kubernetes story. With Blog posts you can: + +* Pitch idea to the meeting or Open a [Contributor Comms Requests issue](https://github.com/kubernetes/community/issues +) +* Create initial draft + * Can be a + * gdoc + * markdown + * hackmd +* Get assigned a pair + * Via issue or meeting +* Work with the Upstream marketing team to polish, and format your blog + * No current cannonical format document + * [Technical consideration](https://github.com/kubernetes/community/issues +) provided by the k8s blog team +* Go to the kubernetes/website repo and send a PR + * Upstream marketing will offer to have your pair help with the PR and shepherd it throught the k8s blog process + +or if you already have everything you think you need you can simply + +* 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 gdoc to markdown? + +* go to: https://discuss.kubernetes.io/ +* Open a new topic +* Paste gdoc into window +* Profit ## Minimum Skills and Experience From 9121d31dfcf17531f817ae0da4e5418f05085d1e Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 14 May 2021 11:30:12 -0400 Subject: [PATCH 2/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- communication/marketing-team/role-handbooks/storytellers.md | 1 - 1 file changed, 1 deletion(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index b71b31714..a08759268 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -15,7 +15,6 @@ TODO add more here There is no one way to get into the kubernetes blog. Below are some options: -The Kubernetes Upstream Marketing team under ContribEx can help you tell a kubernetes story. With Blog posts you can: * Pitch idea to the meeting or Open a [Contributor Comms Requests issue](https://github.com/kubernetes/community/issues ) From cd99f4b2e3cf54eda2eaae1eaed44a3d02b5af7b Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 14 May 2021 11:30:21 -0400 Subject: [PATCH 3/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- communication/marketing-team/role-handbooks/storytellers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index a08759268..b7cee0c27 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -13,7 +13,7 @@ TODO add more here #### Idea Paths -There is no one way to get into the kubernetes blog. Below are some options: +There are multiple ways to successfully a Kubernetes blog. Here are some of the common paths to help you do so: * Pitch idea to the meeting or Open a [Contributor Comms Requests issue](https://github.com/kubernetes/community/issues From 0d5f12af6e29c8b7e676917b0ecd70c47b751b83 Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 14 May 2021 11:30:32 -0400 Subject: [PATCH 4/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- .../role-handbooks/storytellers.md | 42 +++++++++++-------- 1 file changed, 24 insertions(+), 18 deletions(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index b7cee0c27..c52c22eb1 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -16,26 +16,32 @@ TODO add more here There are multiple ways to successfully a Kubernetes blog. Here are some of the common paths to help you do so: -* Pitch idea to the meeting or Open a [Contributor Comms Requests issue](https://github.com/kubernetes/community/issues -) -* Create initial draft - * Can be a - * gdoc - * markdown - * hackmd -* Get assigned a pair - * Via issue or meeting -* Work with the Upstream marketing team to polish, and format your blog - * No current cannonical format document - * [Technical consideration](https://github.com/kubernetes/community/issues -) provided by the k8s blog team -* Go to the kubernetes/website repo and send a PR - * Upstream marketing will offer to have your pair help with the PR and shepherd it throught the k8s blog process +**To start:** -or if you already have everything you think you need you can simply +* 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 -* 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/) +**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 From bafe48ef5ccedd2662ad563e6ff46d920bbce4da Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 9 Jul 2021 19:36:42 -0400 Subject: [PATCH 5/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- communication/marketing-team/role-handbooks/storytellers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index c52c22eb1..19d4179c3 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -13,7 +13,7 @@ TODO add more here #### Idea Paths -There are multiple ways to successfully a Kubernetes blog. Here are some of the common paths to help you do so: +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:** From 4302c3d92e8d9a30e491adc744f3768a00d27e46 Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 9 Jul 2021 19:36:47 -0400 Subject: [PATCH 6/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- communication/marketing-team/role-handbooks/storytellers.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index 19d4179c3..4d1a2e461 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -49,7 +49,8 @@ Converting gdoc to markdown? * go to: https://discuss.kubernetes.io/ * Open a new topic -* Paste gdoc into window +* Paste gdoc into new topic window + * Discourse will automatically convert it to markdown 🎉 * Profit ## Minimum Skills and Experience From 800f837c6e661fbf72a79b3b46d8ed046e781ae9 Mon Sep 17 00:00:00 2001 From: Jason Morgan Date: Fri, 9 Jul 2021 19:36:52 -0400 Subject: [PATCH 7/7] Update communication/marketing-team/role-handbooks/storytellers.md Co-authored-by: Matt Broberg --- communication/marketing-team/role-handbooks/storytellers.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index 4d1a2e461..7ea890bfd 100644 --- a/communication/marketing-team/role-handbooks/storytellers.md +++ b/communication/marketing-team/role-handbooks/storytellers.md @@ -51,7 +51,9 @@ Converting gdoc to markdown? * Open a new topic * Paste gdoc into new topic window * Discourse will automatically convert it to markdown 🎉 -* Profit +* 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 Experience