You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
我们(Kubernetes SIG Docs)通常应避免要求该作者修复可能在所移动的内容中发现的所有语法或拼写错误。
244
244
- 是否存在一些过于复杂晦涩的用词,本可以用简单词汇来代替?
245
245
- 是否有些用词、术语或短语可以用不带歧视性的表达方式代替?
@@ -291,6 +291,99 @@ When reviewing, use the following as a starting point.
291
291
- 变更是否正确出现在 Netlify 预览中了?
292
292
要对列表、代码段、表格、注释和图像等元素格外留心。
293
293
294
+
<!--
295
+
### Blog
296
+
297
+
- Early feedback on blog posts is welcome via a Google Doc or HackMD. Please request input early from the [#sig-docs-blog Slack channel](https://kubernetes.slack.com/archives/CJDHVD54J).
298
+
- Before reviewing blog PRs, be familiar with [Submitting blog posts and case studies](/docs/contribute/new-content/blogs-case-studies/).
- We are willing to mirror any blog article that was published to https://kubernetes.dev/blog/ (the contributor blog) provided that:
308
+
- the mirrored article has the same publication date as the original (it should have the same publication time too, but you can also set a time stamp up to 12 hours later for special cases)
309
+
- for PRs that arrive the original article was merged to https://kubernetes.dev/, there haven't been
310
+
(and won't be) any articles published to the main blog between time that the original and mirrored article
311
+
[will] publish.
312
+
This is because we don't want to add articles to people's feeds, such as RSS, except at the very end of their feed.
313
+
- the original article doesn't contravene any strongly recommended review guidelines or community norms.
314
+
- You should set the canonical URL for the mirrored article, to the URL of the original article
315
+
(you can use a preview to predict the URL and fill this in ahead of actual publication). Use the `canonicalUrl`
316
+
field in [front matter](https://gohugo.io/content-management/front-matter/) for this.
- The [content guide](/docs/contribute/style/content-guide/) applies unconditionally to blog articles
353
+
and the PRs that add them. Bear in mind that some restrictions in the guide state that they are only relevant to documentation; those restrictions don't apply to blog articles.
- The [style guide](/docs/contribute/style/style-guide/) largely also applies to blog PRs, but we make some exceptions.
359
+
360
+
- it is OK to use “we“ in a blog article that has multiple authors, or where the article introduction clearly indicates that the author is writing on behalf of a specific group.
361
+
- we avoid using Kubernetes shortcodes for callouts (such as `{{</* caution */>}}`)
362
+
- statements about the future are OK, albeit we use them with care in official announcements on
363
+
behalf of Kubernetes
364
+
- code samples don't need to use the `{{</* code_sample */>}}` shortcode, and often it is better if they do not
365
+
- we are OK to have authors write an article in their own writing style, so long as most readers
@@ -318,8 +411,7 @@ This lets the author know that this part of your feedback is non-critical.
318
411
If you are considering a pull request for approval and all the remaining feedback is
319
412
marked as a nit, you can merge the PR anyway. In that case, it's often useful to open
320
413
an issue about the remaining nits. Consider whether you're able to meet the requirements
321
-
for marking that new issue as a [Good First Issue](https://www.kubernetes.dev/docs/guide/help-wanted/#good-first-issue);
322
-
if you can, these are a good source.
414
+
for marking that new issue as a [Good First Issue](https://www.kubernetes.dev/docs/guide/help-wanted/#good-first-issue); if you can, these are a good source.
323
415
-->
324
416
作为一名 Reviewer,如果你发现 PR 有一些无关紧要的小问题,例如拼写错误或不正确的空格,
325
417
可以在你的评论前面加上 `nit:`。这样做可以让作者知道该问题不是一个不得了的大问题。
@@ -329,4 +421,3 @@ if you can, these are a good source.
329
421
考虑一下是否能把这些新 Issue 标记为
330
422
[Good First Issue](https://www.kubernetes.dev/docs/guide/help-wanted/#good-first-issue)。
0 commit comments