RFR: Updated AffectsVersion image [v2]
Alexey Ivanov
aivanov at openjdk.org
Thu Aug 7 23:10:53 UTC 2025
On Thu, 31 Jul 2025 17:08:59 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:
>> 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.
I think such longer descriptions will make the image more accessible: anyone who relies on screen reader for accessibility wouldn't be able to figure out what's displayed on the image.
The section with the image is titled **Examples**, and the image provides the five examples. However, the examples aren't as clear, which is proved by the discussion in this PR.
-------------
PR Review Comment: https://git.openjdk.org/guide/pull/149#discussion_r2246319835
More information about the guide-dev
mailing list