RFR: cover the documentation linking options in release notes [v4]

Roger Calnan duke at openjdk.org
Thu Feb 5 00:04:04 UTC 2026


On Mon, 12 Jan 2026 23:26:41 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> src/guide/release-notes.md line 86:
>> 
>>> 84:   * Links of the form `[NumberFormat.setStrict]`, `[NumberFormat.setStrict(boolean)]`, `[NumberFormat.setStrict(true)]`, `[ofFileChannel(FileChannel channel, long offset, long length)]` are supported with any of the separators `[.]`, `[#]` and `[::]`.
>>> 85:   * If a link cannot be found then the string will be rendered as if it had been enclosed in back-ticks and, in the EA release notes only, the string "(link not found)" will be added.
>>> 86:   * For notes of the type `rn-removed` if a link is not found then it will be looked for in the JavaDoc of the previous release family.
>> 
>> In the Guide's "RN Labels" section, you use "RN-Remove" as the name of the label.  Should the case match?  Also, suggest adding link to the Guides' definition of the label.
>
> Good catch Iris! The case should match. Also it should be [RN-Remove]{.jbs-value}

fixed

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

PR Review Comment: https://git.openjdk.org/guide/pull/167#discussion_r2766474747


More information about the guide-dev mailing list