Skip to content

Commit 07814b6

Browse files
authored
Merge pull request #50428 from my-git9/np-921
[zh-cn]Add contribute/blog/release-comms.md
2 parents 656320a + 5eb9803 commit 07814b6

File tree

1 file changed

+152
-0
lines changed

1 file changed

+152
-0
lines changed
Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
---
2+
title: 发布后沟通
3+
content_type: concept
4+
weight: 60
5+
---
6+
<!--
7+
title: Post-release communications
8+
content_type: concept
9+
weight: 60
10+
-->
11+
12+
<!-- overview -->
13+
14+
<!--
15+
The Kubernetes _Release Comms_ team (part of
16+
[SIG Release](http://github.com/kubernetes/community/tree/master/sig-release))
17+
looks after release announcements, which go onto the
18+
[main project blog](/docs/contribute/blog/#main-blog).
19+
20+
After each release, the Release Comms team take over the main blog for a period
21+
and publish a series of additional articles to explain or announce changes related to
22+
that release. These additional articles are termed _post-release comms_.
23+
-->
24+
Kubernetes 的**发布沟通(Release Comms)** 团队(隶属于
25+
[SIG Release](http://github.com/kubernetes/community/tree/master/sig-release)
26+
负责管理发布相关的公告,这些公告会发布在[主项目博客](/docs/contribute/blog/#main-blog)上。
27+
28+
每次发布之后,发布沟通团队会在一段时间内接管主博客,并发布一系列额外的文章,
29+
用于解释或宣布与该版本相关的变更。这些额外的文章被称为**发布后沟通(Post-release comms)**
30+
31+
<!-- body -->
32+
33+
<!--
34+
## Opting in to post-release comms {#opt-in}
35+
36+
During a release cycle, as a contributor, you can opt in to post-release comms about an
37+
upcoming change to Kubernetes.
38+
39+
To opt in you open a draft, _placeholder_ [pull request](http://www.k8s.dev/docs/guide/pull-requests/) (PR)
40+
against [k/website](http://github.com/kubernetes/website). Initially, this can be an
41+
empty commit. Mention the KEP issue or other Kubernetes improvement issue in the description
42+
of your placeholder PR.
43+
-->
44+
## 参与发布后沟通 {#opt-in}
45+
46+
在一个发布周期中,作为贡献者,你可以选择参与关于 Kubernetes
47+
即将发生的变更的发布后沟通。
48+
49+
要选择参与,你需要针对 [k/website](http://github.com/kubernetes/website)
50+
提交一个草稿形式的**占位**[拉取请求(PR)](http://www.k8s.dev/docs/guide/pull-requests/)
51+
最初,这可以是一个空提交。在占位 PR 的描述中,请提及相关的 KEP(Kubernetes Enhancement Proposal)
52+
问题或其他 Kubernetes 改进相关的问题。
53+
54+
<!--
55+
When you open the **draft** pull request, you open it against _main_ as the base branch
56+
and not against the `dev-{{< skew nextMinorVersion >}}` branch. This is different from
57+
the [process](/docs/contribute/new-content/new-features/#open-a-placeholder-pr) for upcoming release changes and new features.
58+
59+
You should also leave a comment on the related [kubernetes/enhancements](http://github.com/kubernetes/enhancements)
60+
issue with a link to the PR to notify the Release Comms team managing this release. Your comment
61+
helps the team see that the change needs announcing and that your SIG has opted in.
62+
63+
As well as the above, you should ideally contact the Release Comms team via Slack
64+
(channel [`#release-comms`](http://kubernetes.slack.com/archives/CNT9Y603D)) to let them
65+
know that you have done this and would like to opt in.
66+
-->
67+
当你提交**草稿**拉取请求时,需要以 **main** 作为基础分支,
68+
而不是针对 `dev-{{< skew nextMinorVersion >}}` 分支。
69+
这与即将发布的变更和新功能的[流程](/zh-cn/docs/contribute/new-content/new-features/#open-a-placeholder-pr)不同。
70+
71+
你还应在相关的 [kubernetes/enhancements](http://github.com/kubernetes/enhancements)
72+
问题下留下评论,并附上拉取请求的链接,以通知负责本次发布的发布沟通团队。
73+
你的评论有助于团队了解该变更需要发布公告,并确认你的 SIG 已选择参与。
74+
75+
除此之外,理想情况下,你还应通过 Slack(频道
76+
[`#release-comms`](http://kubernetes.slack.com/archives/CNT9Y603D)
77+
联系发布沟通团队,告知他们你已完成上述操作并希望选择参与。
78+
79+
<!--
80+
## Preparing the article content {#preparation}
81+
82+
You should follow the usual [article submission](/docs/contribute/blog/article-submission/)
83+
process to turn your placeholder PR into something ready for review. However, for
84+
post-release comms, you may not have a _writing buddy_; instead, the Release Comms team
85+
may assign a member of the team to help guide what you're doing.
86+
-->
87+
## 准备文章内容 {#preparation}
88+
89+
你应该遵循常规的[文章提交](/zh-cn/docs/contribute/blog/article-submission/)流程,
90+
将你的占位 PR 转变为可供评审的内容。然而,对于发布后沟通,
91+
你可能不会有一个**写作伙伴**;取而代之的是,发布沟通团队可能会指派一名成员来帮助指导你的工作。
92+
93+
<!--
94+
You should [squash](http://www.k8s.dev/docs/guide/pull-requests/#squashing) the commits
95+
in your pull request; if you're not sure how to, it's absolutely OK to ask Release Comms or
96+
the blog team for help.
97+
98+
Provided that your article is flagged as a draft (`draft: true`) in the
99+
[front matter](http://gohugo.io/content-management/front-matter/), the PR can merge at any
100+
time during the release cycle.
101+
-->
102+
你应该[压缩](http://www.k8s.dev/docs/guide/pull-requests/#squashing)拉取请求中的提交;
103+
如果你不确定如何操作,完全可以向发布沟通团队或博客团队寻求帮助。
104+
105+
只要你的文章在[前言](http://gohugo.io/content-management/front-matter/)中被标记为草稿(`draft: true`),
106+
该 PR 就可以在发布周期的任何时间合并。
107+
108+
<!--
109+
## Publication
110+
111+
Ahead of the actual release, the Release Comms team check what content is ready (if it's
112+
not ready by the deadline, and you didn't get an exception, then the announcement won't
113+
be included). They build a schedule for the articles that will go out and open new
114+
pull requests to turn those articles from draft to published.
115+
-->
116+
## 发布
117+
118+
在实际发布之前,发布沟通团队会检查哪些内容已经准备就绪
119+
(如果到了截止日期仍未准备好,且你没有获得豁免,那么公告将不会被收录)。
120+
他们为即将发布的文章制定时间表,并开启新的拉取请求,将这些文章从草稿转为已发布。
121+
以将这些文章从草稿状态变为已发布状态。
122+
123+
{{< caution >}}
124+
<!--
125+
All these pull requests to actually publish post-release articles **must** be held
126+
(Prow command `/hold`) until the release has actually happened.
127+
-->
128+
所有用于实际发布发布后文章的拉取请求**必须**被暂停(Prow 命令 `/hold`),
129+
直到发布实际完成为止。
130+
{{< /caution >}}
131+
132+
<!--
133+
The blog team approvers still provide final sign off on promoting the content from draft
134+
to accepted for publication. Ahead of release day, the PR (or PRs) for publishing these
135+
announcements should have LGTM (“looks good to me”) and approved labels, along with the
136+
**do-not-merge/hold** label to ensure the PR doesn't merge too early.
137+
-->
138+
博客团队的批准者仍然需要对从草稿到可发布的内容提供最终的签字批准。
139+
在发布日前,用于发布这些公告的拉取请求(PR)应已获得 LGTM(“我觉得不错”)
140+
和批准标签,同时还需要添加 **do-not-merge/hold** 标签,以确保 PR 不会过早合并。
141+
142+
<!--
143+
Release Comms / the Release Team can then _unhold_ that PR (or set of PRs) as soon as the
144+
website Git repository is unfrozen after the actual release.
145+
146+
On the day each article is scheduled to publish, automation triggers a website build and that
147+
article becomes visible.
148+
-->
149+
一旦实际发布完成并且网站 Git 仓库解冻,发布沟通团队或发布团队可以立即**取消保留** PR(或一组 PR)
150+
PR(或一组 PR)的 **hold** 状态。
151+
152+
在每篇文章预定发布的当天,自动化流程将触发网站构建,该文章将会变成可见。

0 commit comments

Comments
 (0)