Skip to content

Commit 9d8e758

Browse files
authored
Merge pull request #2818 from graz-dev/edit-comms-handbook
Add writing buddy assignment process
2 parents e40f963 + 7d9a898 commit 9d8e758

File tree

2 files changed

+25
-0
lines changed

2 files changed

+25
-0
lines changed

release-team/role-handbooks/communications/README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,10 @@ It helps to work closely with the Release Lead and use the respective SIG Slack
114114
115115
When a placeholder PR is created, make sure the PR has been opened using a `draft:true` parameter in its metadata. Feature blogs should not be merged **until after the release date and the comms team has assigned a publication date**.
116116

117+
Once the placeholder PRs are open, **assign a writing buddy to each PR as needed**. Select the writing buddy from the KEP authors of the other open placeholder PRs and pair them up. The writing buddy will act as a peer reviewer and provide support for the main author of the feature blog. Some feature blog PRs are written collaboratively within SIGs or are opened with the blog content already complete; these may not need a writing buddy.
118+
For more information about the writing buddy assignment process and their role, please refer to [this documentation page](https://kubernetes.io/docs/contribute/blog/writing-buddy/).
119+
Example messaging can be found [here](/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md).
120+
117121
#### Creating a blog publication schedule
118122

119123
**The Comms team establishes the feature blog publication schedule.** Other members of the release team or blog reviewers may contribute ideas and feedback on the schedule, but ultimately the schedule is determined by the Comms team.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Writing Buddy Assignement
2+
3+
This is a message to send to the owners of the Feature Blog in the placeholder PRs to assign them a writing buddy.
4+
5+
```
6+
Hi @xx 👋 vx.yy Communications team here,
7+
8+
@BUDDY as author of #BUDDY-PR, I'd like you to be a [writing buddy](https://kubernetes.io/docs/contribute/blog/writing-buddy/) for @xx on this PR.
9+
10+
Please:
11+
12+
- Review this PR, paying attention to the [guidelines](https://kubernetes.io/docs/contribute/blog/guidelines/) and [review hints](https://kubernetes.io/docs/contribute/blog/writing-buddy/#pull-request-review)
13+
- Update your own PR based on any best practices you identify that should be applied
14+
- Remember to be compassionate with your fellow article author
15+
```
16+
17+
You'd need to update the following placeholders:
18+
- `@xx`: Mention PR's author
19+
- `x.yy`: The upcoming Kubernetes version, such as 1.33, 1.34, etc.
20+
- `@BUDDY`: Mention the choosed writing buddy to pair to this PR
21+
- `#BUDDY-PR`: Link the buddy's PR

0 commit comments

Comments
 (0)