diff options
| author | Jason Morgan <jmorgan@f9vs.com> | 2021-05-14 11:30:32 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-05-14 11:30:32 -0400 |
| commit | 0d5f12af6e29c8b7e676917b0ecd70c47b751b83 (patch) | |
| tree | f721a4ef7b24efa98b5f3d5cc8ffbcf1ed371e25 | |
| parent | cd99f4b2e3cf54eda2eaae1eaed44a3d02b5af7b (diff) | |
Update communication/marketing-team/role-handbooks/storytellers.md
Co-authored-by: Matt Broberg <matt@opensource.com>
| -rw-r--r-- | communication/marketing-team/role-handbooks/storytellers.md | 46 |
1 files changed, 26 insertions, 20 deletions
diff --git a/communication/marketing-team/role-handbooks/storytellers.md b/communication/marketing-team/role-handbooks/storytellers.md index b7cee0c2..c52c22eb 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 - -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/) +**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 |
