Skip to content

Commit 6e194c9

Browse files
committed
Merge pull request kubernetes#13218 from mbforbes/versioning
Add patch notes to versioning doc
2 parents 12b5906 + 9bd219c commit 6e194c9

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/design/versioning.md

+8
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,14 @@ Here is an example major release cycle:
6868

6969
It may seem a bit strange to complete the v2 API before v2.0 is released, but *adding* a v2 API is not a breaking change. *Removing* the v2beta\* APIs *is* a breaking change, which is what necessitates the major version bump. There are other ways to do this, but having the major release be the fresh start of that release's API without the baggage of its beta versions seems most intuitive out of the available options.
7070

71+
# Patches
72+
73+
Patch releases are intended for critical bug fixes to the latest minor version, such as addressing security vulnerabilities, fixes to problems affecting a large number of users, severe problems with no workaround, and blockers for products based on Kubernetes.
74+
75+
They should not contain miscellaneous feature additions or improvements, and especially no incompatibilities should be introduced between patch versions of the same minor version (or even major version).
76+
77+
Dependencies, such as Docker or Etcd, should also not be changed unless absolutely necessary, and also just to fix critical bugs (so, at most patch version changes, not new major nor minor versions).
78+
7179
# Upgrades
7280

7381
* Users can upgrade from any Kube 1.x release to any other Kube 1.x release as a rolling upgrade across their cluster. (Rolling upgrade means being able to upgrade the master first, then one node at a time. See #4855 for details.)

0 commit comments

Comments
 (0)