@@ -24,8 +24,8 @@ In most cases, new work on Kubernetes documentation begins with an issue in GitH
24
24
then review, categorize and tag issues as needed. Next, you or another member
25
25
of the Kubernetes community open a pull request with changes to resolve the issue.
26
26
-->
27
- 如果你发现 Kubernetes 文档中存在问题或者你有一个关于新内容的想法,可以考虑
28
- 提出一个问题 (issue)。你只需要具有 [ GitHub 账号] ( https://github.com/join ) 和 Web
27
+ 如果你发现 Kubernetes 文档中存在问题或者你有一个关于新内容的想法,
28
+ 可以考虑提出一个问题 (issue)。你只需要具有 [ GitHub 账号] ( https://github.com/join ) 和 Web
29
29
浏览器就可以完成这件事。
30
30
31
31
在大多数情况下,Kubernetes 文档的新工作都是开始于 GitHub 上的某个问题。
@@ -53,10 +53,10 @@ they can take action on your issue.
53
53
54
54
如果你希望就改进已有内容提出建议或者在文档中发现了错误,请创建一个问题(issue)。
55
55
56
- 1 . 点击右侧边栏的 ** 报告问题 ** 按钮。浏览器会重定向到一个 GitHub 问题页面,其中
57
- 包含了一些预先填充的内容 。
56
+ 1 . 点击右侧边栏的 ** 提交文档问题 ** 按钮。浏览器会重定向到一个 GitHub 问题页面,
57
+ 其中包含了一些预先填充的内容 。
58
58
1 . 请描述遇到的问题或关于改进的建议。尽可能提供细节信息。
59
- 1 . 点击 ** 提交新问题 ** .
59
+ 1 . 点击 ** Submit new issue ** 。
60
60
61
61
提交之后,偶尔查看一下你所提交的问题,或者开启 GitHub 通知。
62
62
评审人(reviewers)和其他社区成员可能在针对所提问题采取行动之前,问一些问题。
@@ -70,11 +70,11 @@ still file an issue. Either:
70
70
- Choose an existing page in the section you think the content belongs in and click **Create an issue**.
71
71
- Go to [GitHub](https://github.com/kubernetes/website/issues/new/) and file the issue directly.
72
72
-->
73
- ## 关于新内容的建议
73
+ ## 关于新内容的建议 {#suggesting-new-content}
74
74
75
- 如果你对新内容有想法,但是你有不确定这些内容应该放在哪里 ,你仍可以提出问题。
75
+ 如果你对新内容有想法,但是你不确定这些内容应该放在哪里 ,你仍可以提出问题。
76
76
77
- - 在预期的节区中选择一个现有页面,点击 ** 创建 issue ** .
77
+ - 在预期的节区中选择一个现有页面,点击 ** 提交文档问题 ** 。
78
78
- 前往 [ GitHub Issues 页面] ( https://github.com/kubernetes/website/issues/new/ ) ,
79
79
直接记录问题。
80
80
@@ -100,19 +100,19 @@ fellow contributors. For example, "The docs are terrible" is not
100
100
helpful or polite feedback.
101
101
-->
102
102
103
- ## 如何更好地记录问题
103
+ ## 如何更好地记录问题 {#how-to-file-great-issues}
104
104
105
105
在记录问题时,请注意以下事项:
106
106
107
107
- 提供问题的清晰描述,描述具体缺失的内容、过期的内容、错误的内容或者需要改进的文字。
108
108
- 解释该问题对用户的特定影响。
109
- - 将给定问题的范围限定在一个工作单位范围内。如果问题牵涉的领域较大,可以将其分解为多个
110
- 小一点的问题。 例如:"Fix the security docs" 是一个过于宽泛的问题,而
109
+ - 将给定问题的范围限定在一个工作单位范围内。如果问题牵涉的领域较大,可以将其分解为多个小一点的问题。
110
+ 例如:"Fix the security docs" 是一个过于宽泛的问题,而
111
111
"Add details to the 'Restricting network access' topic"
112
112
就是一个足够具体的、可操作的问题。
113
113
- 搜索现有问题的列表,查看是否已经有相关的或者类似的问题已被记录。
114
- - 如果新问题与某其他问题或 PR 有关联,可以使用其完整 URL 或带 ` # ` 字符的 PR 编号
115
- 来引用之。 例如:` Introduced by #987654 ` 。
116
- - 遵从[ 行为准则] ( /community/code-of-conduct/ ) 。尊重同行贡献者。
114
+ - 如果新问题与某其他问题或 PR 有关联,可以使用其完整 URL 或带 ` # ` 字符的 PR 编号来引用之。
115
+ 例如:` Introduced by #987654 ` 。
116
+ - 遵从[ 行为准则] ( /zh-cn/ community/code-of-conduct/ ) 。尊重同行贡献者。
117
117
例如,"The docs are terrible" 就是无用且无礼的反馈。
118
118
0 commit comments