RFR: clarify how to set the affects versions

[Alexey Ivanov]

On Thu, 15 Feb 2024 17:03:20 GMT, Magnus Ihse Bursie <ihse at openjdk.org> wrote:

> > Alternatively, SVG (Scalable Vector Graphics) can be used, yet it probably requires more effort to create than using Mermaid code.
> 
> Just a raw SVG file does not provide any additional value over a PNG in this respect. The idea is that if the file is easily created/edited using a "source code" description, then it should be in the repo in that format. If you need an external tool to edit it, then you might as well have the end result. (I know a SVG is scalable and stored as an XML document, but that's not really the point here.)

I haven't used Mermaid, likely it's a better tool for this kind of picture.

SVG has its value over PNG in that it's a text-based format, it is easier to modify and all the change history is preserved whereas PNG is a binary file, the changes to it aren't tracked and modifying it isn't as simple.

-------------

PR Comment: https://git.openjdk.org/guide/pull/119#issuecomment-1946730525