Skip to content

Commit 6ce860a

Browse files
committed
[zh] Update deprecation-policy.md
Signed-off-by: xin.li <[email protected]>
1 parent f490abd commit 6ce860a

File tree

1 file changed

+27
-40
lines changed

1 file changed

+27
-40
lines changed

content/zh/docs/reference/using-api/deprecation-policy.md

Lines changed: 27 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -142,37 +142,41 @@ might have to add an equivalent field or represent it as an annotation.
142142
添加一个新的等效字段或者将其表现为一个注解。
143143

144144
<!--
145-
**Rule #3: An API version in a given track may not be deprecated until a new
146-
API version at least as stable is released.**
145+
**Rule #3: An API version in a given track may not be deprecated in favor of a less stable API version.**
147146
148-
GA API versions can replace GA API versions as well as beta and alpha API
149-
versions. Beta API versions *may not* replace GA API versions.
147+
* GA API versions can replace beta and alpha API versions.
148+
* Beta API versions can replace earlier beta and alpha API versions, but *may not* replace GA API versions.
149+
* Alpha API versions can replace earlier alpha API versions, but *may not* replace GA or beta API versions.
150150
-->
151-
**规则 #3:给定类别的 API 版本在新的、稳定性未降低的 API 版本发布之前不可被废弃**
151+
**规则 #3:给定类别的 API 版本不可被弃用以支持稳定性更差的 API 版本**
152152

153-
一个正式发布的(GA)API 版本可替换现有的正式 API 版本或 alpha、beta API 版本。
154-
Beta API 版本 *不可以* 替代正式的 API 版本。
153+
* 一个正式发布的(GA)API 版本可替换 beta 或 alpha API 版本。
154+
* Beta API 版本可以替换早期的 beta 和 alpha API 版本,但 **不可以** 替换正式的 API 版本。
155+
* Alpha API 版本可以替换早期的 alpha API 版本,但 **不可以** 替换正式的或 beta API 版本。
155156

156157
<!--
157-
**Rule #4a: Other than the most recent API versions in each track, older API
158-
versions must be supported after their announced deprecation for a duration of
159-
no less than:**
158+
**Rule #4a: minimum API lifetime is determined by the API stability level**
160159
161-
* **GA: 12 months or 3 releases (whichever is longer)**
162-
* **Beta: 9 months or 3 releases (whichever is longer)**
163-
* **Alpha: 0 releases**
160+
* **GA API versions may be marked as deprecated, but must not be removed within a major version of Kubernetes**
161+
* **Beta API versions must be supported for 9 months or 3 releases (whichever is longer) after deprecation**
162+
* **Alpha API versions may be removed in any release without prior deprecation notice**
164163
165-
This covers the [maximum supported version skew of 2 releases](/docs/setup/release/version-skew-policy/).
164+
This ensures beta API support covers the [maximum supported version skew of 2 releases](/releases/version-skew-policy/).
166165
-->
167-
**规则 #4a:除了每类 API 版本中的最新版本,旧的 API 版本在其被宣布被废弃之后
168-
至少以下时长内仍需被支持:**
166+
**规则 #4a:最短 API 生命周期由 API 稳定性级别决定**
169167

170-
* **GA:12 个月或者 3 个发布版本(取其较长者)**
171-
* **Beta: 9 个月或者 3 个发布版本(取其较长者**
172-
* **Alpha: 0 个发布版本**
168+
* **GA API 版本可以被标记为已弃用,但不得在 Kubernetes 的主要版本中删除**
169+
* **Beta API 版本必须支持 9 个月或弃用后的 3 个版本(以较长者为准**
170+
* **Alpha API 版本可能会在任何版本中被删除,不另行通知**
173171

174-
这里也包含了关于[最大支持 2 个发布版本的版本偏差](/zh/docs/setup/release/version-skew-policy/)
175-
的约定。
172+
这确保了 beta API 支持涵盖了[最多 2 个版本的支持版本偏差](/zh/releases/version-skew-policy/)
173+
174+
{{< note >}}
175+
<!--
176+
There are no current plans for a major version revision of Kubernetes that removes GA APIs.
177+
-->
178+
目前没有删除正式版本 API 的 Kubernetes 主要版本修订计划。
179+
{{< /note >}}
176180

177181
<!--
178182
Until [#52185](https://github.com/kubernetes/kubernetes/issues/52185) is
@@ -363,9 +367,9 @@ API versions are supported in a series of subsequent releases.
363367
<td>
364368
<ul>
365369
<!-- li>v2beta2 is deprecated, "action required" relnote</li>
366-
<li>v1 is deprecated, "action required" relnote</li -->
370+
<li>v1 is deprecated in favor of v2, but will not be removed</li -->
367371
<li>v2beta2 已被弃用,发布说明中包含对应的 "action required(采取行动)" 说明</li>
368-
<li>v1 已被弃用,发布说明中包含对应的 "action required(采取行动)" 说明</li>
372+
<li>v1 已被弃用,取而代之的是 v2,但不会被删除</li>
369373
</ul>
370374
</td>
371375
</tr>
@@ -400,23 +404,6 @@ API versions are supported in a series of subsequent releases.
400404
</ul>
401405
</td>
402406
</tr>
403-
<tr>
404-
<td>X+16</td>
405-
<!-- td>v2, v1 (deprecated)</td -->
406-
<td>v2、v1(已弃用)</td>
407-
<td>v2</td>
408-
<td></td>
409-
</tr>
410-
<tr>
411-
<td>X+17</td>
412-
<td>v2</td>
413-
<td>v2</td>
414-
<td>
415-
<ul>
416-
<li>v1 被删除,发布说明中包含对应的 "action required(采取行动)" 说明</li>
417-
</ul>
418-
</td>
419-
</tr>
420407
</tbody>
421408
</table>
422409

0 commit comments

Comments
 (0)