[WIP]: Add blog editor onboarding guide - #796
Conversation
|
/hold |
|
A new user left a comment. This user must be approved by a Netlify team owner before comments can be displayed. |
1 similar comment
|
A new user left a comment. This user must be approved by a Netlify team owner before comments can be displayed. |
|
This is still a WIP; it needs to have the people parts of the process, not just the technical ones /hold |
|
Should probably add this to the comms meeting agenda for July 7. |
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: KashishV999 The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
|
/hold cancel |
clarification about date Added author url
2bcab85 to
42231c5
Compare
| be published. Here is where to find them: | ||
|
|
||
| - [Open blog PRs on k/website](https://github.com/kubernetes/website/pulls?q=is%3Aopen+is%3Apr+label%3Aarea%2Fblog) | ||
| - [Open PRs on k/contributor-site](https://github.com/kubernetes/contributor-site/pulls) |
There was a problem hiding this comment.
| - [Open PRs on k/contributor-site](https://github.com/kubernetes/contributor-site/pulls) | |
| - [Open PRs on k/contributor-site](https://github.com/kubernetes/contributor-site/pulls?q=is%3Aopen+is%3Apr+label%3Aarea%2Fblog) |
|
|
||
| - [Blog-specific exceptions](https://kubernetes.io/docs/contribute/blog/article-submission/#article-content) | ||
|
|
||
| *I know it's a lot to take in at once,and that's okay. Start with one thing, |
There was a problem hiding this comment.
| *I know it's a lot to take in at once,and that's okay. Start with one thing, | |
| *I know it's a lot to take in at once, and that's okay. Start with one thing, |
|
|
||
| The blog publishes to one or both of these two sites: | ||
|
|
||
| - [kubernetes.io](https://kubernetes.io) : the main Kubernetes blog, stored in the [k/website GitHub repo](https://github.com/kubernetes/website/) |
There was a problem hiding this comment.
| - [kubernetes.io](https://kubernetes.io) : the main Kubernetes blog, stored in the [k/website GitHub repo](https://github.com/kubernetes/website/) | |
| - [kubernetes.io](https://kubernetes.io): the main Kubernetes blog, stored in the [k/website GitHub repo](https://github.com/kubernetes/website/) |
| The blog publishes to one or both of these two sites: | ||
|
|
||
| - [kubernetes.io](https://kubernetes.io) : the main Kubernetes blog, stored in the [k/website GitHub repo](https://github.com/kubernetes/website/) | ||
| - [kubernetes.dev](https://www.kubernetes.dev) : the contributor blog, stored in the [k/contributor-site GitHub repo](https://github.com/kubernetes/contributor-site/) |
There was a problem hiding this comment.
| - [kubernetes.dev](https://www.kubernetes.dev) : the contributor blog, stored in the [k/contributor-site GitHub repo](https://github.com/kubernetes/contributor-site/) | |
| - [kubernetes.dev](https://www.kubernetes.dev): the contributor blog, stored in the [k/contributor-site GitHub repo](https://github.com/kubernetes/contributor-site/) |
|
|
||
| ## The details that are easy to miss | ||
|
|
||
| This is the part I really want you to slow down on. These are the small things that quietly delay publication. |
There was a problem hiding this comment.
Do you think it is valuable to provide an example for this?
|
|
||
| Hugo uses `1-01-01` as its default when no publish date is set yet. | ||
|
|
||
| **ALWAYS CHECK ON MOBILE TOO** |
There was a problem hiding this comment.
I think this could be a note https://kubernetes.io/docs/contribute/blog/guidelines/#original-content
|
|
||
| Replace `{YYYY}`, `{MM}`, `{DD}`, and `{slug}` with the actual values. | ||
|
|
||
| *Now how is the publication date assigned?* To open the publish PR, one has to jump on [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel to discuss the publication date with the other blog editors. The team confirms the date, suggest a change if needed, and once everyone is aligned , a publish PR can be created *(It's that easy!)* |
There was a problem hiding this comment.
| *Now how is the publication date assigned?* To open the publish PR, one has to jump on [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel to discuss the publication date with the other blog editors. The team confirms the date, suggest a change if needed, and once everyone is aligned , a publish PR can be created *(It's that easy!)* | |
| ### Now how is the publication date assigned? | |
| To open the publish PR, one has to jump on [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel to discuss the publication date with the other blog editors. The team confirms the date, suggest a change if needed, and once everyone is aligned , a publish PR can be created *(It's that easy!)* |
| to contribute to open source, to share something with the community. That | ||
| deserves respect, especially when leaving feedback. | ||
|
|
||
| When something needs attention: |
There was a problem hiding this comment.
| When something needs attention: | |
| ## When something needs attention: |
| A good tip would be to start attending meetings and introducing yourself | ||
| to your colleagues. :) | ||
|
|
||
| **Slack:** [Join here](https://communityinviter.com/apps/kubernetes/community), then look for the [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel. |
There was a problem hiding this comment.
| **Slack:** [Join here](https://communityinviter.com/apps/kubernetes/community), then look for the [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel. | |
| **Slack:** [Join here](https://slack.k8s.io), then look for the [#sig-docs-blog](https://kubernetes.slack.com/archives/CJDHVD54J) channel. |
| If you are interested in exploring other SIGs, the [community groups page](https://www.kubernetes.dev/community/community-groups/) | ||
| has all the SIGs, their schedules, and how to join. | ||
|
|
||
|
|
|
Good blog 👍🏽 |
|
/retitle [WIP]: Add blog editor onboarding guide |
Adds a blog on how-to guide for new Kubernetes blog editors/reviewers