Add examples to roll-forward table #46238
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -1,16 +1,29 @@ | ||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||
| author: adegeo | ||||||||||||||||||||||||||
| ms.author: adegeo | ||||||||||||||||||||||||||
| ms.date: 05/16/2025 | ||||||||||||||||||||||||||
| ms.topic: include | ||||||||||||||||||||||||||
| recommendations: false | ||||||||||||||||||||||||||
| --- | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| | Value | Description | | ||||||||||||||||||||||||||
| |---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||||||||||||||||||||||||||
| | `Minor` | **Default** if not specified.<br>Roll-forward to the lowest higher minor version (and highest available patch version within that minor version), if requested minor version is missing. If the requested minor version is present, then the `LatestPatch` policy is used. | | ||||||||||||||||||||||||||
| | `Major` | Roll-forward to the next available higher major version (at its lowest available minor version, and highest available patch version within that minor version), if requested major version is missing. If the requested major version is present, then the `Minor` policy is used. | | ||||||||||||||||||||||||||
| | `LatestPatch` | Roll-forward to the highest patch version available for the requested major and minor versions. This value disables minor version roll-forward. | | ||||||||||||||||||||||||||
| | `LatestMinor` | Roll-forward to the highest minor version available for the requested major version (and highest available patch version within that minor version), even if requested minor version is present. | | ||||||||||||||||||||||||||
| | `LatestMajor` | Roll-forward to highest available major version (and highest available minor and patch version within that major version), even if requested major is present. | | ||||||||||||||||||||||||||
| | `Disable` | Don't roll-forward, only bind to the specified version. This policy isn't recommended for general use since it disables the ability to roll-forward to the latest patches. This value is only recommended for testing. | | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| For example, suppose an application requests version `8.0.0`, while the locally available versions are `8.2.0`, `8.2.3`, `8.4.5`, `9.0.0`, `9.0.6`, `9.7.8`. | ||||||||||||||||||||||||||
| Then the resolved version is as follows in each case: | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| | Value | Resolved version | Resolved version if `8.0.1` were also available | | ||||||||||||||||||||||||||
| |---------------|------------------|-------------------------------------------------| | ||||||||||||||||||||||||||
| | `Minor` | `8.2.3` | `8.0.1` | | ||||||||||||||||||||||||||
| | `Major` | `8.2.3` | `8.0.1` | | ||||||||||||||||||||||||||
| | `LatestPatch` | (fails) | `8.0.1` | | ||||||||||||||||||||||||||
| | `LatestMinor` | `8.4.5` | `8.4.5` | | ||||||||||||||||||||||||||
| | `LatestMajor` | `9.7.8` | `9.7.8` | | ||||||||||||||||||||||||||
| | `Disable` | (fails) | (fails) | | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
|
There was a problem hiding this comment. I don't think this should be here as this is an include file that only has a single table. The extra context would be provided by the actual article that uses this include file, if appropriate.
Suggested change
There was a problem hiding this comment. Oh good point; I'll move it to docs/docs/core/versions/selection.md Line 160 in 58615fb |
||||||||||||||||||||||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Even though I wrote this years ago, it took me quite a while to decipher what "lowest higher minor version" actually is. I wonder if using something like
next available minor versionorfirst higher available minoris clearer? I'm not sure though.. thoughts?There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As a first pass, I've gone with "next available", which matches the wording of
Major.