diff options
| author | Frederico Muñoz <fsmunoz@gmail.com> | 2022-07-29 15:20:56 +0100 |
|---|---|---|
| committer | Frederico Muñoz <fsmunoz@gmail.com> | 2022-07-29 15:20:56 +0100 |
| commit | 2da5f9946195ad09dcf31835c91d71ef41b95c2a (patch) | |
| tree | 97a0914b14cf1ba2fda4ea29e62fb917244d2cde | |
| parent | d23d4d8cee12f2f0dafc46e8335ca39ab27b11a6 (diff) | |
Added instructions on pre-PR draft review
Signed-off-by: Frederico Muñoz <fsmunoz@gmail.com>
| -rw-r--r-- | communication/marketing-team/storytelling-resources/blog-guidelines.md | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/communication/marketing-team/storytelling-resources/blog-guidelines.md b/communication/marketing-team/storytelling-resources/blog-guidelines.md index a774be5d..7c1b2a6b 100644 --- a/communication/marketing-team/storytelling-resources/blog-guidelines.md +++ b/communication/marketing-team/storytelling-resources/blog-guidelines.md @@ -16,8 +16,21 @@ Other types of content, like Kubernetes capabilities and tutorials, are better s The quickest way to get involved is to let the team in [#sig-contribex-comms](https://kubernetes.slack.com/archives/C03KT3SUJ20) know that you have an idea for an article. +To reduce the amount of editing done directly in GitHub, a two-stage approach is highly recommended: + +1. Create your proposal draft in [Google Docs](https://docs.google.com/) or + HackMD (https://hackmd.io), and ask for a review in + [#sig-contribex-comms](https://kubernetes.slack.com/archives/C03KT3SUJ20). + This will allow easier editing, especially if major changes or restructuring + is needed. +2. Once you have reflected any feedback in the proposal draft, submit the + revised article as a Pull Request. Additional changes can still be made + during the PR review process, but they should be more about details than + major modifications. + For now, our official process is to use [SIG Docs' system](/sig-docs/blog-subproject/README.md), with one change: instead of directly creating the file in the Kubernetes site repository, as instructed abovem it's initially created in the [contributor-site](https://github.com/kubernetes/contributor-site), in the appropriate folder (i.e. the right year in `contributor-site/content/en/blog/`). This will lead to an initial review process before it gets mirrored to the main Kubernetes site. + ## Blogger Expectations, Responsibilities, and Info Anyone is welcome to contribute when they have time. |
