From e8c87171753bdbf86a471959c4c8da0a8fabb203 Mon Sep 17 00:00:00 2001 From: Graziano Casto Date: Tue, 29 Jul 2025 11:08:14 +0200 Subject: [PATCH 1/2] Add writing buddy assignment process --- .../role-handbooks/communications/README.md | 4 ++++ .../templates/writing-buddy-assignment.md | 21 +++++++++++++++++++ 2 files changed, 25 insertions(+) create mode 100644 release-team/role-handbooks/communications/templates/writing-buddy-assignment.md diff --git a/release-team/role-handbooks/communications/README.md b/release-team/role-handbooks/communications/README.md index dd42c9b2f15..d066cadbe02 100644 --- a/release-team/role-handbooks/communications/README.md +++ b/release-team/role-handbooks/communications/README.md @@ -114,6 +114,10 @@ It helps to work closely with the Release Lead and use the respective SIG Slack 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**. +Once the placeholder PRs are open, **assign a writing buddy to each PR**. 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. +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/). +Example messaging can be found [here](/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md). + #### Creating a blog publication schedule **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. diff --git a/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md b/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md new file mode 100644 index 00000000000..81875e9192a --- /dev/null +++ b/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md @@ -0,0 +1,21 @@ +# Writing Buddy Assignement + +This is a message to send to the owners of the Feature Blog placeholder PRs to assign them a writing buddy. + +``` +Hi @xx @haircommander 👋 vx.yy Communications team here, + +@BUDDY as author of #BUDDY-PR, I'd like you to be a writing buddy for @xx on this PR. + +Please: + +- Review this PR, paying attention to the guidelines and review hints +- Update your own PR based on any best practices you identify that should be applied +- Remember to be compassionate with your fellow article author +``` + +You'd need to update the following placeholders: +- `@xx`: Mention PR's author +- `x.yy`: The upcoming Kubernetes version, such as 1.33, 1.34, etc. +- `@BUDDY`: Mention the choosed writing buddy to pair to this PR +- `#BUDDY-PR`: Link the buddy's PR \ No newline at end of file From 7bf8345af252669ab03654fe9b31a38bd5dd490b Mon Sep 17 00:00:00 2001 From: Graziano Casto Date: Tue, 29 Jul 2025 18:09:39 +0200 Subject: [PATCH 2/2] Fix template --- .../communications/templates/writing-buddy-assignment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md b/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md index 81875e9192a..1eb940d37be 100644 --- a/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md +++ b/release-team/role-handbooks/communications/templates/writing-buddy-assignment.md @@ -3,7 +3,7 @@ This is a message to send to the owners of the Feature Blog placeholder PRs to assign them a writing buddy. ``` -Hi @xx @haircommander 👋 vx.yy Communications team here, +Hi @xx 👋 vx.yy Communications team here, @BUDDY as author of #BUDDY-PR, I'd like you to be a writing buddy for @xx on this PR.