docs
docs copied to clipboard
Add examples to roll-forward table
Summary
The wording of the table is currently ambiguous, so I've added more words around it and also added an examples table.
I thought carefully about the table, but I'm a) not certain of the actual intended semantics, and b) not certain I got the table right even given the semantics. So please don't assume I know what I'm doing here.
As a check, I asked Claude 3.7 Sonnet to write the same table, but it resolved the ambiguity in the original docs differently from the way I did; it picked 8.2.0 rather than 8.2.3 in the left-hand column, because it resolved the ambiguity in the direction of "lowest patch number" rather than "highest patch number". I only went with "highest patch number" because of the stated downside of Disable, preventing roll-forward to latest patch versions.