summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrederico Muñoz <fsmunoz@gmail.com>2022-07-29 15:20:56 +0100
committerFrederico Muñoz <fsmunoz@gmail.com>2022-07-29 15:20:56 +0100
commit2da5f9946195ad09dcf31835c91d71ef41b95c2a (patch)
tree97a0914b14cf1ba2fda4ea29e62fb917244d2cde
parentd23d4d8cee12f2f0dafc46e8335ca39ab27b11a6 (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.md13
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.