RFR: Clarified language around release notes

Ivan Bereziuk duke at openjdk.org
Thu Nov 13 10:30:18 UTC 2025


On Thu, 13 Nov 2025 00:13:28 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

> The word "note" was used to refer to a release note, a release note sub-task, and a comment in a JBS issue - this could be confusing. Made it more explicit.
> Also updated the usage of Fix version for release notes which was not described correctly.

Nice improvements. I like them.

src/guide/release-notes.md line 81:

> 79:       * If more than one release note is required for the same set of fixes, then open additional sub-tasks with the same affects version - see [JDK-8073861](https://bugs.openjdk.org/browse/JDK-8073861) as an example.
> 80:   * Release notes across backports
> 81:     * If an issue is backported to earlier releases the same release note will be used - just add the new release version in the [Affects Version/s]{.jbs-field} and [Fix Version/s]{.jbs-field} fields of the release note sub-task.

Might be a missing comma.
Suggestion:

    * If an issue is backported to earlier releases, the same release note will be used - just add the new release version in the [Affects Version/s]{.jbs-field} and [Fix Version/s]{.jbs-field} fields of the release note sub-task.

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

Marked as reviewed by Domest0s at github.com (no known OpenJDK username).

PR Review: https://git.openjdk.org/guide/pull/164#pullrequestreview-3458994464
PR Review Comment: https://git.openjdk.org/guide/pull/164#discussion_r2522820030


More information about the guide-dev mailing list