RFR: Updated AffectsVersion image [v2]
Alexey Ivanov
aivanov at openjdk.org
Thu Aug 7 23:10:53 UTC 2025
On Thu, 31 Jul 2025 16:59:32 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:
>> Ok. Did some more changes. The image should be fairly clean and makes more sense now with the updated descriptions, I think. My main problem with the old descriptions was that they repeated how to use the labels rather than explaining the situation in the example.
>
> I've been working on high priority issues, I still am…
>
> Anyway I've raised my own pull request in #153. Both versions of the image look nearly identical: my version has smaller arrows and smaller circles; both `12-na` and `11-wnf` are aligned.
>
> What I particularly don't like about positioning the text closer to the lines is that the ends of commas in case 2 is hidden by the timeline line.
> My main problem with the old descriptions was that they repeated how to use the labels rather than explaining the situation in the example.
Yes, that's the thing! I've been thinking about it too. Does it makes sense to expand the descriptions of the cases like this:
1. Affects Version contains 8 only which means this issue is applicable to 8 and all future releases (until it's fixed).
2. Affects Version contains 8, ~~8u40, 9 and 12~~, yet 8 already implies that these releases are affected.
3. (no change)
4. Affects Version contains 8, the issue is fixed in 11; then the `12-na` label indicates the issue is not applicable to 12 and subsequent versions.
5. Affects Version contains 8, the issue is fixed in 21 and is backported to 17; the label `11-wnf` indicates the fix will not be backported to 11 or 8.
-------------
PR Review Comment: https://git.openjdk.org/guide/pull/149#discussion_r2245945985
More information about the guide-dev
mailing list