Skip to content

Commit 38803a4

Browse files
authored
Merge pull request #37421 from windsonsea/blogcase
[zh] sync blogs-case-studies.md
2 parents 5ee0781 + bddf74b commit 38803a4

File tree

1 file changed

+97
-48
lines changed

1 file changed

+97
-48
lines changed

content/zh-cn/docs/contribute/new-content/blogs-case-studies.md

Lines changed: 97 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,10 @@ Case studies require extensive review before they're approved.
2626
<!--
2727
## The Kubernetes Blog
2828
29-
The Kubernetes blog is used by the project to communicate new features, community reports, and any news that might be relevant to the Kubernetes community.
30-
This includes end users and developers.
31-
Most of the blog's content is about things happening in the core project, but we encourage you to submit about things happening elsewhere in the ecosystem too!
29+
The Kubernetes blog is used by the project to communicate new features, community reports, and any
30+
news that might be relevant to the Kubernetes community. This includes end users and developers.
31+
Most of the blog's content is about things happening in the core project, but we encourage you to
32+
submit about things happening elsewhere in the ecosystem too!
3233
3334
Anyone can write a blog post and submit it for review.
3435
-->
@@ -45,8 +46,8 @@ Kubernetes 博客用于项目发布新功能特性、
4546
<!--
4647
### Submit a Post
4748
48-
Blog posts should not be commercial in nature and should consist of original content that applies broadly to the Kubernetes community.
49-
Appropriate blog content includes:
49+
Blog posts should not be commercial in nature and should consist of original content that applies
50+
broadly to the Kubernetes community. Appropriate blog content includes:
5051
5152
- New Kubernetes capabilities
5253
- Kubernetes projects updates
@@ -76,7 +77,6 @@ Unsuitable content includes:
7677
- Partner updates without an integration and customer story
7778
- Syndicated posts (language translations ok)
7879
-->
79-
8080
不合适的博客内容包括:
8181

8282
- 供应商产品推介
@@ -86,12 +86,17 @@ Unsuitable content includes:
8686
<!--
8787
To submit a blog post, follow these steps:
8888
89-
1. [Sign the CLA](https://kubernetes.io/docs/contribute/start/#sign-the-cla) if you have not yet done so.
90-
1. Have a look at the Markdown format for existing blog posts in the [website repository](https://github.com/kubernetes/website/tree/master/content/en/blog/_posts).
89+
1. [Sign the CLA](https://github.com/kubernetes/community/blob/master/CLA.md)
90+
if you have not yet done so.
91+
1. Have a look at the Markdown format for existing blog posts in the
92+
[website repository](https://github.com/kubernetes/website/tree/master/content/en/blog/_posts).
9193
1. Write out your blog post in a text editor of your choice.
92-
1. On the same link from step 2, click the Create new file button. Paste your content into the editor. Name the file to match the proposed title of the blog post, but don’t put the date in the file name. The blog reviewers will work with you on the final file name and the date the blog will be published.
94+
1. On the same link from step 2, click the Create new file button. Paste your content into the editor.
95+
Name the file to match the proposed title of the blog post, but don’t put the date in the file name.
96+
The blog reviewers will work with you on the final file name and the date the blog will be published.
9397
1. When you save the file, GitHub will walk you through the pull request process.
94-
1. A blog post reviewer will review your submission and work with you on feedback and final details. When the blog post is approved, the blog will be scheduled for publication.
98+
1. A blog post reviewer will review your submission and work with you on feedback and final details.
99+
When the blog post is approved, the blog will be scheduled for publication.
95100
-->
96101
要提交博文,你可以遵从以下步骤:
97102

@@ -110,9 +115,16 @@ To submit a blog post, follow these steps:
110115
### Guidelines and expectations
111116
112117
- Blog posts should not be vendor pitches.
113-
- Articles must contain content that applies broadly to the Kubernetes community. For example, a submission should focus on upstream Kubernetes as opposed to vendor-specific configurations. Check the [Documentation style guide](/docs/contribute/style/content-guide/#what-s-allowed) for what is typically allowed on Kubernetes properties.
114-
- Links should primarily be to the official Kubernetes documentation. When using external references, links should be diverse - For example a submission shouldn't contain only links back to a single company's blog.
115-
- Sometimes this is a delicate balance. The [blog team](https://kubernetes.slack.com/messages/sig-docs-blog/) is there to give guidance on whether a post is appropriate for the Kubernetes blog, so don't hesitate to reach out.
118+
- Articles must contain content that applies broadly to the Kubernetes community. For example, a
119+
submission should focus on upstream Kubernetes as opposed to vendor-specific configurations.
120+
Check the [Documentation style guide](/docs/contribute/style/content-guide/#what-s-allowed) for
121+
what is typically allowed on Kubernetes properties.
122+
- Links should primarily be to the official Kubernetes documentation. When using external
123+
references, links should be diverse - For example a submission shouldn't contain only links
124+
back to a single company's blog.
125+
- Sometimes this is a delicate balance. The [blog team](https://kubernetes.slack.com/messages/sig-docs-blog/)
126+
is there to give guidance on whether a post is appropriate for the Kubernetes blog, so don't
127+
hesitate to reach out.
116128
-->
117129
### 指导原则和期望 {#guidelines-and-expectations}
118130

@@ -130,9 +142,12 @@ To submit a blog post, follow these steps:
130142
所以,需要帮助的时候不要犹豫。
131143
<!--
132144
- Blog posts are not published on specific dates.
133-
- Articles are reviewed by community volunteers. We'll try our best to accommodate specific timing, but we make no guarantees.
134-
- Many core parts of the Kubernetes projects submit blog posts during release windows, delaying publication times. Consider submitting during a quieter period of the release cycle.
135-
- If you are looking for greater coordination on post release dates, coordinating with [CNCF marketing](https://www.cncf.io/about/contact/) is a more appropriate choice than submitting a blog post.
145+
- Articles are reviewed by community volunteers. We'll try our best to accommodate specific
146+
timing, but we make no guarantees.
147+
- Many core parts of the Kubernetes projects submit blog posts during release windows, delaying
148+
publication times. Consider submitting during a quieter period of the release cycle.
149+
- If you are looking for greater coordination on post release dates, coordinating with
150+
[CNCF marketing](https://www.cncf.io/about/contact/) is a more appropriate choice than submitting a blog post.
136151
- Sometimes reviews can get backed up. If you feel your review isn't getting the attention it needs,
137152
you can reach out to the blog team on the [`#sig-docs-blog` Slack channel](https://kubernetes.slack.com/messages/sig-docs-blog/)
138153
to ask in real time.
@@ -150,19 +165,24 @@ To submit a blog post, follow these steps:
150165

151166
<!--
152167
- Blog posts should be relevant to Kubernetes users.
168+
153169
- Topics related to participation in or results of Kubernetes SIGs activities are always on
154-
topic (see the work in the [Upstream Marketing Team](https://github.com/kubernetes/community/blob/master/communication/marketing-team/storytelling-resources/blog-guidelines.md#upstream-marketing-blog-guidelines)
170+
topic (see the work in the [Contributor Comms Team](https://github.com/kubernetes/community/blob/master/communication/contributor-comms/storytelling-resources/blog-guidelines.md#upstream-marketing-blog-guidelines)
155171
for support on these posts).
156-
- The components of Kubernetes are purposely modular, so tools that use existing integration points like CNI and CSI are on topic.
157-
- Posts about other CNCF projects may or may not be on topic. We recommend asking the blog team before submitting a draft.
158-
- Many CNCF projects have their own blog. These are often a better choice for posts. There are times of major feature or milestone for a CNCF project that users would be interested in reading on the Kubernetes blog.
159-
- Blog posts about contributing to the Kubernetes project should be in the [Kubernetes Contributors site](https://kubernetes.dev)
172+
- The components of Kubernetes are purposely modular, so tools that use existing integration
173+
points like CNI and CSI are on topic.
174+
- Posts about other CNCF projects may or may not be on topic. We recommend asking the blog team
175+
before submitting a draft.
176+
- Many CNCF projects have their own blog. These are often a better choice for posts. There are
177+
times of major feature or milestone for a CNCF project that users would be interested in
178+
reading on the Kubernetes blog.
179+
- Blog posts about contributing to the Kubernetes project should be in the
180+
[Kubernetes Contributors site](https://kubernetes.dev)
160181
-->
161182
- 博客内容应该对 Kubernetes 用户有用。
162183
- 与参与 Kubernetes SIG 活动相关,或者与这类活动的结果相关的主题通常是切题的。
163-
请参考[上游推广团队](https://github.com/kubernetes/community/blob/master/communication/marketing-team/storytelling-resources/blog-guidelines.md#upstream-marketing-blog-guidelines)的工作以获得对此类博文的支持。
164-
- Kubernetes 的组件都有意设计得模块化,因此使用类似 CNI、CSI 等集成点的工具
165-
通常都是切题的。
184+
请参考 [贡献者沟通(Contributor Comms)团队](https://github.com/kubernetes/community/blob/master/communication/contributor-comms/storytelling-resources/blog-guidelines.md#upstream-marketing-blog-guidelines)的工作以获得对此类博文的支持。
185+
- Kubernetes 的组件都有意设计得模块化,因此使用类似 CNI、CSI 等集成点的工具通常都是切题的。
166186
- 关于其他 CNCF 项目的博客可能切题也可能不切题。
167187
我们建议你在提交草稿之前与博客团队联系。
168188
- 很多 CNCF 项目有自己的博客。这些博客通常是更好的选择。
@@ -172,9 +192,11 @@ To submit a blog post, follow these steps:
172192
<!--
173193
- Blog posts should be original content
174194
- The official blog is not for repurposing existing content from a third party as new content.
175-
- The [license](https://github.com/kubernetes/website/blob/main/LICENSE) for the blog allows commercial use of the content for commercial purposes, just not the other way around.
195+
- The [license](https://github.com/kubernetes/website/blob/main/LICENSE) for the blog allows
196+
commercial use of the content for commercial purposes, but not the other way around.
176197
- Blog posts should aim to be future proof
177-
- Given the development velocity of the project, we want evergreen content that won't require updates to stay accurate for the reader.
198+
- Given the development velocity of the project, we want evergreen content that won't require
199+
updates to stay accurate for the reader.
178200
- It can be a better choice to add a tutorial or update official documentation than to write a
179201
high level overview as a blog post.
180202
- Consider concentrating the long technical content as a call to action of the blog post, and
@@ -187,15 +209,19 @@ To submit a blog post, follow these steps:
187209
- 博客文章的内容应该在一段时间内不过期。
188210
- 考虑到项目的开发速度,我们希望读者看到的是不必更新就能保持长期准确的内容。
189211
- 有时候,在官方文档中添加一个教程或者进行内容更新都是比博客更好的选择。
190-
- 可以考虑在博客文章中将较长技术内容的重点放在鼓励读者自行尝试上,或者
191-
放在问题域本身或者为什么读者应该关注某个话题上
212+
- 可以考虑在博客文章中将较长技术内容的重点放在鼓励读者自行尝试上,
213+
或者放在问题域本身或者为什么读者应该关注某个话题上
192214

193215
<!--
194216
### Technical Considerations for submitting a blog post
195217
196-
Submissions need to be in Markdown format to be used by the [Hugo](https://gohugo.io/) generator for the blog. There are [many resources available](https://gohugo.io/documentation/) on how to use this technology stack.
218+
Submissions need to be in Markdown format to be used by the [Hugo](https://gohugo.io/) generator
219+
for the blog. There are [many resources available](https://gohugo.io/documentation/) on how to use
220+
this technology stack.
197221
198-
We recognize that this requirement makes the process more difficult for less-familiar folks to submit, and we're constantly looking at solutions to lower this bar. If you have ideas on how to lower the barrier, please volunteer to help out.
222+
We recognize that this requirement makes the process more difficult for less-familiar folks to
223+
submit, and we're constantly looking at solutions to lower this bar. If you have ideas on how to
224+
lower the barrier, please volunteer to help out.
199225
-->
200226
### 提交博客的技术考虑 {#technical-consideration-for-submitting-a-blog-post}
201227

@@ -207,22 +233,30 @@ We recognize that this requirement makes the process more difficult for less-fam
207233
如果你有降低难度的好主意,请自荐帮忙。
208234

209235
<!--
210-
The SIG Docs [blog subproject](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject) manages the review process for blog posts. For more information, see [Submit a post](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject#submit-a-post).
236+
The SIG Docs [blog subproject](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject)
237+
manages the review process for blog posts. For more information, see
238+
[Submit a post](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject#submit-a-post).
211239
212240
To submit a blog post follow these directions:
213241
-->
214-
SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject) 负责管理博客的评阅过程。
242+
SIG Docs
243+
[博客子项目](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject)负责管博客的评阅过程。
215244
更多信息可参考[提交博文](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject#submit-a-post)
216245

217246
要提交博文,你可以遵从以下指南:
218247

219248
<!--
220-
- [Open a pull request](/docs/contribute/new-content/open-a-pr/#fork-the-repo) with a new blog post. New blog posts go under the [`content/en/blog/_posts`](https://github.com/kubernetes/website/tree/main/content/en/blog/_posts) directory.
249+
- [Open a pull request](/docs/contribute/new-content/open-a-pr/#fork-the-repo) with a new blog post.
250+
New blog posts go under the [`content/en/blog/_posts`](https://github.com/kubernetes/website/tree/main/content/en/blog/_posts)
251+
directory.
221252
222-
- Ensure that your blog post follows the correct naming conventions and the following frontmatter (metadata) information:
253+
- Ensure that your blog post follows the correct naming conventions and the following frontmatter
254+
(metadata) information:
223255
224-
- The Markdown file name must follow the format `YYYY-MM-DD-Your-Title-Here.md`. For example, `2020-02-07-Deploying-External-OpenStack-Cloud-Provider-With-Kubeadm.md`.
225-
- Do **not** include dots in the filename. A name like `2020-01-01-whats-new-in-1.19.md` causes failures during a build.
256+
- The Markdown file name must follow the format `YYYY-MM-DD-Your-Title-Here.md`. For example,
257+
`2020-02-07-Deploying-External-OpenStack-Cloud-Provider-With-Kubeadm.md`.
258+
- Do **not** include dots in the filename. A name like `2020-01-01-whats-new-in-1.19.md` causes
259+
failures during a build.
226260
- The front matter must include the following:
227261
-->
228262
- [发起一个包含新博文的 PR](/zh-cn/docs/contribute/new-content/open-a-pr/#fork-the-repo)
@@ -244,18 +278,25 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
244278
slug: text-for-URL-link-here-no-spaces
245279
---
246280
```
247-
<!--
248-
- The first or initial commit message should be a short summary of the work being done and should stand alone as a description of the blog post. Please note that subsequent edits to your blog will be squashed into this main commit, so it should be as useful as possible.
281+
282+
<!--
283+
- The first or initial commit message should be a short summary of the work being done and
284+
should stand alone as a description of the blog post. Please note that subsequent edits to
285+
your blog will be squashed into this main commit, so it should be as useful as possible.
286+
249287
- Examples of a good commit message:
250-
- _Add blog post on the foo kubernetes feature_
251-
- _blog: foobar announcement_
288+
- _Add blog post on the foo kubernetes feature_
289+
- _blog: foobar announcement_
252290
- Examples of bad commit message:
253291
- _Add blog post_
254292
- _._
255293
- _initial commit_
256294
- _draft post_
257-
- The blog team will then review your PR and give you comments on things you might need to fix. After that the bot will merge your PR and your blog post will be published.
258-
-->
295+
296+
- The blog team will then review your PR and give you comments on things you might need to fix.
297+
After that the bot will merge your PR and your blog post will be published.
298+
-->
299+
259300
- 第一个或者最初的提交的描述信息中应该包含一个所作工作的简单摘要,
260301
并作为整个博文的一个独立描述。
261302
请注意,对博文的后续修改编辑都会最终合并到此主提交中,所以此提交的描述信息
@@ -271,8 +312,14 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
271312
- 博客团队会对 PR 内容进行评阅,为你提供一些评语以便修订。
272313
之后,机器人会将你的博文合并并发表。
273314

274-
<!--
275-
- If the content of the blog post contains only content that is not expected to require updates to stay accurate for the reader, it can be marked as evergreen and exempted from the automatic warning about outdated content added to blog posts older than one year.
315+
<!--
316+
- The blog team will then review your PR and give you comments on things you might need to fix.
317+
After that the bot will merge your PR and your blog post will be published.
318+
319+
- If the content of the blog post contains only content that is not expected to require updates
320+
to stay accurate for the reader, it can be marked as evergreen and exempted from the automatic
321+
warning about outdated content added to blog posts older than one year.
322+
276323
- To mark a blog post as evergreen, add this to the front matter:
277324

278325
```yaml
@@ -281,7 +328,7 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
281328
- Examples of content that should not be marked evergreen:
282329
- **Tutorials** that only apply to specific releases or versions and not all future versions
283330
- References to pre-GA APIs or features
284-
-->
331+
-->
285332

286333
- 如果博文的内容仅包含预期无需更新就能对读者保持精准的内容,
287334
则可以将这篇博文标记为长期有效(evergreen),
@@ -299,13 +346,15 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
299346
<!--
300347
## Submit a case study
301348

302-
Case studies highlight how organizations are using Kubernetes to solve
303-
real-world problems. The Kubernetes marketing team and members of the {{< glossary_tooltip text="CNCF" term_id="cncf" >}} collaborate with you on all case studies.
349+
Case studies highlight how organizations are using Kubernetes to solve real-world problems. The
350+
Kubernetes marketing team and members of the {{< glossary_tooltip text="CNCF" term_id="cncf" >}}
351+
collaborate with you on all case studies.
304352

305353
Have a look at the source for the
306354
[existing case studies](https://github.com/kubernetes/website/tree/main/content/en/case-studies).
307355

308-
Refer to the [case study guidelines](https://github.com/cncf/foundation/blob/master/case-study-guidelines.md) and submit your request as outlined in the guidelines.
356+
Refer to the [case study guidelines](https://github.com/cncf/foundation/blob/master/case-study-guidelines.md)
357+
and submit your request as outlined in the guidelines.
309358
-->
310359
## 提交案例分析 {#submit-a-case-study}
311360

0 commit comments

Comments
 (0)