Skip to content

Commit 2da5f99

Browse files
committed
Added instructions on pre-PR draft review
Signed-off-by: Frederico Muñoz <[email protected]>
1 parent d23d4d8 commit 2da5f99

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

communication/marketing-team/storytelling-resources/blog-guidelines.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,21 @@ Other types of content, like Kubernetes capabilities and tutorials, are better s
1616

1717
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.
1818

19+
To reduce the amount of editing done directly in GitHub, a two-stage approach is highly recommended:
20+
21+
1. Create your proposal draft in [Google Docs](https://docs.google.com/) or
22+
HackMD (https://hackmd.io), and ask for a review in
23+
[#sig-contribex-comms](https://kubernetes.slack.com/archives/C03KT3SUJ20).
24+
This will allow easier editing, especially if major changes or restructuring
25+
is needed.
26+
2. Once you have reflected any feedback in the proposal draft, submit the
27+
revised article as a Pull Request. Additional changes can still be made
28+
during the PR review process, but they should be more about details than
29+
major modifications.
30+
1931
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.
2032

33+
2134
## Blogger Expectations, Responsibilities, and Info
2235

2336
Anyone is welcome to contribute when they have time.

0 commit comments

Comments
 (0)