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
Copy file name to clipboardExpand all lines: content/zh-cn/docs/contribute/new-content/new-features.md
+63-39Lines changed: 63 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,9 @@ card:
24
24
<!-- overview -->
25
25
26
26
<!--
27
-
Each major Kubernetes release introduces new features that require documentation. New releases also bring updates to existing features and documentation (such as upgrading a feature from alpha to beta).
27
+
Each major Kubernetes release introduces new features that require documentation.
28
+
New releases also bring updates to existing features and documentation
29
+
(such as upgrading a feature from alpha to beta).
28
30
29
31
Generally, the SIG responsible for a feature submits draft documentation of the
30
32
feature as a pull request to the appropriate development branch of the
@@ -33,8 +35,7 @@ editorial feedback or edits the draft directly. This section covers the branchin
33
35
conventions and process used during a release by both groups.
34
36
-->
35
37
Kubernetes 的每个主要版本发布都会包含一些需要文档说明的新功能。
36
-
新的发行版本也会对已有功能特性和文档(例如将某功能特性从 Alpha 升级为
37
-
Beta)进行更新。
38
+
新的发行版本也会更新已有的功能特性和文档(例如将某功能特性从 Alpha 升级为 Beta)。
38
39
39
40
通常,负责某功能特性的 SIG 要为功能特性的文档草拟文档,并针对 `kubernetes/website`
@@ -223,7 +224,8 @@ When ready, populate your placeholder PR with feature documentation and change
223
224
the state of the PR from draft to **ready for review**. To mark a pull request
224
225
as ready for review, navigate to the merge box and click **Ready for review**.
225
226
226
-
Do your best to describe your feature and how to use it. If you need help structuring your documentation, ask in the `#sig-docs` Slack channel.
227
+
Do your best to describe your feature and how to use it. If you need help
228
+
structuring your documentation, ask in the `#sig-docs` Slack channel.
227
229
228
230
When you complete your content, the documentation person assigned to your feature reviews it.
229
231
To ensure technical accuracy, the content may also require a technical review from corresponding SIG(s).
@@ -270,10 +272,11 @@ add documentation elsewhere and link to that.
270
272
通常一段话就够了;若要长篇阐述,请在其他地方添加文档,并为其添加链接。
271
273
272
274
<!--
273
-
Also,
274
-
to ensure your feature gate appears in the [Alpha/Beta Feature gates](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features) table, include the following details
275
-
in the [front matter](https://gohugo.io/content-management/front-matter/) of your Markdown
When you change a feature gate to disabled-by-default to enabled-by-default,
313
+
When you change a feature gate from disabled-by-default to enabled-by-default,
311
314
you may also need to change other documentation (not just the list of
312
315
feature gates). Watch out for language such as ”The `exampleSetting` field
313
316
is a beta field and disabled by default. You can enable it by enabling the
@@ -318,22 +321,39 @@ is a beta field and disabled by default. You can enable it by enabling the
318
321
你可以通过启用 `ProcessExampleThings` 特性门控来启用此字段。”
319
322
320
323
<!--
321
-
If your feature is GA'ed or deprecated,
322
-
include an additional `stage` entry within the `stages` block in the description file.
323
-
Ensure that the Alpha and Beta stages remain intact.
324
-
This step transitions the feature gate from the
325
-
[Feature gates for Alpha/Feature](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features) table
326
-
to [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-graduated-or-deprecated-features) table. For example:
324
+
If your feature is GA'ed or deprecated, include an additional `stage` entry within
325
+
the `stages` block in the description file.
326
+
Ensure that the Alpha and Beta stages remain intact. This step transitions the
327
+
feature gate from the
328
+
[Feature gates for Alpha/Beta](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-alpha-or-beta-features) table
329
+
to [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates/#feature-gates-for-graduated-or-deprecated-features)
Eventually, Kubernetes will stop including the feature gate at all. To signify the removal of a feature gate,
355
-
include `removed: true` in the front matter of the respective description file.
356
-
This action triggers the transition of the feature gate
357
-
from [Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates-removed/#feature-gates-that-are-removed) section to a dedicated page titled
358
-
[Feature Gates (removed)](/docs/reference/command-line-tools-reference/feature-gates-removed/), including its description.
375
+
Eventually, Kubernetes will stop including the feature gate at all.
376
+
To signify the removal of a feature gate, include `removed: true` in
377
+
the front matter of the respective description file.
378
+
Making that change means that the feature gate information moves from the
379
+
[Feature gates for graduated or deprecated features](/docs/reference/command-line-tools-reference/feature-gates-removed/#feature-gates-that-are-removed)
0 commit comments