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
{{ message }}
Repository navigation
Commit 4033f09
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: blogs/_posts/2026-10-01-versioning.md
+6-4Lines changed: 6 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,22 +40,24 @@ If you find any problems with the RC, please [create an issue on GitHub](https:/
40
40
41
41
## Definition of support
42
42
43
-
DocumentDB will publish one new major version each year. The major versions are on branches such as `release/v3`.
43
+
DocumentDB aims to publish one new major version each year. The major versions are on branches such as `release/v3`.
44
44
Security fixes will be backported to supported release branches, with new artifacts built until support ends. Other bug fixes will be backported case by case.
45
-
A major version will be supported in this way until three months after the next major version is released.
45
+
A major version will be supported until three months after the next major version is released.
46
46
47
47
Backports of security fixes will be added to the LTS version with a patch version bump. For example, a security fix could bump the long-term support branch to v3.0-1, but not v3.1-0.
48
48
The long-term support track will not get any minor updates, only patch updates.
49
49
50
50
## The main development track
51
51
52
-
Major releases are time-based. Minor releases, however, will continue to be pushed out as they have been before, as development work completes. Instead of backporting, the artifacts on the main development track will be built only when the next minor version releases. In this way, all security and bug fixes will come as a user of the development track rolls forward with the latest minor updates.
52
+
Major releases are time-based. Minor releases, however, will continue to be pushed out as development work completes.
53
+
The artifacts on the main development track will be built only on minor version releases. At that point the previous minor is deprecated and all development track users should update immediately.
54
+
In this way, all security and bug fixes will come as a user of the development track rolls forward with the latest minor updates.
53
55
54
56
## Upgrade paths
55
57
56
58
DocumentDB will support direct in-place upgrades between consecutive long-term support major versions.
57
59
For example, if you are using v1.0-2, and v2.0-0 is released as part of a new major, there will be instructions for how to update to that next version before v1.0 falls out of support.
58
60
59
-
There is also a simple path from the current major release to the latest minor release of that same major. This will allow for a simple switch from long-term support to the latest builds.
61
+
There is also a direct upgrade path from the current major release to the latest minor release of that same major. This will allow for a simple switch from long-term support to the latest builds.
60
62
61
63
Release candidates are different. Upgrades from release candidate versions will not be supported. Release candidates use the same extension version as the first full release for that major, so there is no reliable extension upgrade path from an RC to the final release.
0 commit comments