RFR: More information on fix version usage

[Roger Calnan]

On Tue, 18 Jun 2024 18:15:00 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

> Added more information on how to set fix version when closing an issue.
> Also fixed some broken links.

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

> 263: Once the work on an issue has been completed the issues [Status]{.jbs-field} should be in a "completed" state. There are two "completed" states: [Resolved]{.jbs-value} and [Closed]{.jbs-value}. These are accompanied by a [Resolution]{.jbs-field} and a [Fix Version/s]{.jbs-value}. Which combination of [Status]{.jbs-field}, [Resolution]{.jbs-field}, and [Fix Version/s]{.jbs-value} you should use depends on how the issue is completed.
> 264: 
> 265: Most resolutions are used to close an issue so that it ends up being [Closed]{.jbs-value} directly, but resolutions that indicates that a change has been integrated into a Project repository must go through the [Resolved]{.jbs-value} state. An issue in [Resolved]{.jbs-value} state needs to go through [verification](#verifying-an-issue) to end up as [Closed]{.jbs-value}. For the JDK project in almost all cases the bots will transition the issue to [Resolved]{.jbs-value}/[Fixed]{.jbs-value} when the changeset is integrated to the repository.

"needs to go through"
is it more "may go through"?

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

> 265: Most resolutions are used to close an issue so that it ends up being [Closed]{.jbs-value} directly, but resolutions that indicates that a change has been integrated into a Project repository must go through the [Resolved]{.jbs-value} state. An issue in [Resolved]{.jbs-value} state needs to go through [verification](#verifying-an-issue) to end up as [Closed]{.jbs-value}. For the JDK project in almost all cases the bots will transition the issue to [Resolved]{.jbs-value}/[Fixed]{.jbs-value} when the changeset is integrated to the repository.
> 266: 
> 267: The [Fix Version/s]{.jbs-field} field should indicate when an issue was fixed. The most common value for this field is a JDK version number. There are some special values available for this field in JBS, these should only be used is special cases as outlined in this Guide.

for special cases that are outlined in this Guide

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

PR Review Comment: https://git.openjdk.org/guide/pull/128#discussion_r1644961707
PR Review Comment: https://git.openjdk.org/guide/pull/128#discussion_r1644960954