docs icon indicating copy to clipboard operation
docs copied to clipboard

Add examples to roll-forward table

Open Smaug123 opened this issue 6 months ago • 0 comments

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.

Smaug123 avatar May 16 '25 17:05 Smaug123