RFR: cover the documentation linking options in release notes [v4]
Jesper Wilhelmsson
jwilhelm at openjdk.org
Mon Jan 12 23:30:11 UTC 2026
On Mon, 12 Jan 2026 17:44:32 GMT, Iris Clark <iris at openjdk.org> wrote:
>> Roger Calnan has updated the pull request incrementally with one additional commit since the last revision:
>>
>> additional notes
>
> 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}
-------------
PR Review Comment: https://git.openjdk.org/guide/pull/167#discussion_r2684231827
More information about the guide-dev
mailing list