Skip to content

Commit df9195b

Browse files
authored
Merge pull request #1199 from DirectXMan12/docs/common-versioning
📖 Be more specific about compat in VERSIONING
2 parents c726ff0 + 5d96a69 commit df9195b

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

VERSIONING.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,23 @@ counts as a "library project", but otherwise follows the guidelines
88
exactly.
99

1010
[guidelines]: https://sigs.k8s.io/kubebuilder-release-tools/VERSIONING.md
11+
12+
## Compatiblity and Release Support
13+
14+
For release branches, we generally tend to support backporting one (1)
15+
major release (`release-{X-1}` or `release-0.{Y-1}`), but may go back
16+
further if the need arises and is very pressing (e.g. security updates).
17+
18+
### Dependency Support
19+
20+
Note the [guidelines on dependency versions][dep-versions]. Particularly:
21+
22+
- We **DO** guarantee Kubernetes REST API compability -- if a given
23+
version of controller-runtime stops working with what should be
24+
a supported version of Kubernetes, this is almost certainly a bug.
25+
26+
- We **DO NOT** guarantee any particular compability matrix between
27+
kubernetes library dependencies (client-go, apimachinery, etc); Such
28+
compability is infeasible due to the way those libraries are versioned.
29+
30+
[dep-versions]: https://sigs.k8s.io/kubebuilder-release-tools/VERSIONING.md#kubernetes-version-compatibility

0 commit comments

Comments
 (0)