RFR: Clarifications and X-wnf label [v4]

David Holmes dholmes at openjdk.org
Mon Jan 29 05:59:49 UTC 2024


On Thu, 25 Jan 2024 15:37:15 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> Fixed a bug, cleaned up a few JBS field references, and added the X-wnf label to the dictionary.
>
> Jesper Wilhelmsson has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Fixed typos

src/guide/jbs-jdk-bug-system.md line 352:

> 350:       The [Affects Version/s]{.jbs-field} field is used to indicate the releases where an issue has been seen - it's implied that the issue is also applicable to newer releases. Where this isn't the case - for instance a bug in code that was removed in *(Rel)* - then use *(Rel)*[-na]{.jbs-label} to indicate this. Note that there should only be **one** *(Rel)*[-na]{.jbs-label} label on any JBS issue. The label indicates the first known release where the issue is not present. If it's found that the issue is not present in an earlier release, change the label to indicate this.
> 351: 
> 352:       It's not recommended to specify update releases like 17u4 or 21u in the label. Please stick to labels like [17-na]{.jbs-label} and [21-na]{.jbs-label}.

Again this can get a bit grey. Suppose an issue is present in 17 but not in 21+, and the change in 21 is then backported to 17uN. In that case putting 17-na would be very misleading as the bug is present in 17 (and 17uM M<N)

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

PR Review Comment: https://git.openjdk.org/guide/pull/118#discussion_r1469107688


More information about the guide-dev mailing list