Skip to content

Commit 3dfffd3

Browse files
committed
Clarify deprecation rule 3
1 parent b599a32 commit 3dfffd3

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,11 +73,11 @@ knows how to convert between them in both directions. Additionally, any new
7373
field added in v2 must be able to round-trip to v1 and back, which means v1
7474
might have to add an equivalent field or represent it as an annotation.
7575

76-
**Rule #3: An API version in a given track may not be deprecated until a new
77-
API version at least as stable is released.**
76+
**Rule #3: An API version in a given track may not be deprecated in favor of a less stable API version.**
7877

79-
GA API versions can replace GA API versions as well as beta and alpha API
80-
versions. Beta API versions *may not* replace GA API versions.
78+
* GA API versions can replace beta and alpha API versions.
79+
* Beta API versions can replace earlier beta and alpha API versions, but *may not* replace GA API versions.
80+
* Alpha API versions can replace earlier alpha API versions, but *may not* replace GA or beta API versions.
8181

8282
**Rule #4a: Other than the most recent API versions in each track, older API
8383
versions must be supported after their announced deprecation for a duration of

0 commit comments

Comments
 (0)