RFR: clarify how to set the affects versions [v6]
David Holmes
dholmes at openjdk.org
Mon Mar 4 06:04:55 UTC 2024
On Fri, 1 Mar 2024 14:02:05 GMT, calnan <duke at openjdk.org> wrote:
>> moved together information on how the set the affects version and the meaning of the (Rel)-na and (Rel)-wnf labelss
>
> calnan has updated the pull request incrementally with one additional commit since the last revision:
>
> updates from feedback
Marked as reviewed by dholmes (Author).
src/guide/jbs-jdk-bug-system.md line 92:
> 90:
> 91: * The [Affects Version/s]{.jbs-field} isn't meant to be an exhaustive list of releases the issue is relevant to - it should initially be set to the release the issue was reproduced or identified on, and by implication it will be relevant to all releases past that point (see the [Usage of (Rel)[-na]{.jbs-label} Label](#usage-of-rel-na-label)). If it's later found to be applicable to an earlier release family then adding that earlier release is encouraged if the issue needs to be fixed in that release.
> 92: * Do not add additional release values to [Affects Version/s]{.jbs-field} for the same release family. For example, if there is the value [11.0.2]{.jbs-value}, don't add [11.0.5]{.jbs-value}, [11.0.7]{.jbs-value} etc. Adding an additional value for a separate release family where it's still reproducible, e.g. JDK [21]{.jbs-value}, is encouraged, especially if there is not currently a feature release value set, or, it has been a few releases since it was last reproduced/reviewed. For example if the [Affects Version/s]{.jbs-field} is JDK [8]{.jbs-value}, but it is still relevant to the latest mainline release.
Comma after "For example" in the last sentence please.
-------------
PR Review: https://git.openjdk.org/guide/pull/119#pullrequestreview-1913433629
PR Review Comment: https://git.openjdk.org/guide/pull/119#discussion_r1510628462
More information about the guide-dev
mailing list