RFR: cover the documentation linking options in release notes [v2]
Roger Calnan
duke at openjdk.org
Thu Dec 18 18:52:04 UTC 2025
On Thu, 18 Dec 2025 16:25:59 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:
>> Roger Calnan has updated the pull request incrementally with one additional commit since the last revision:
>>
>> formatting changes
>
> src/guide/release-notes.md line 76:
>
>> 74: **Linking of JBS issues**
>> 75:
>> 76: * any JBS ID of the form `JDK-NNNNNNN` will be linked
>
> Please use complete sentences with capital letter and period in all bullets.
done
> src/guide/release-notes.md line 81:
>
>> 79:
>> 80: * the linking options defined in JavaDoc [MarkDown](https://openjdk.org/jeps/467#Links) are supported.
>> 81: * links to the JDK tools is supported. To differentiate between `[JarSigner]` the class, and `[jarsigner]` the tool, the tool reference should be in all lowercase.
>
> I think it would be nice if "JDK tools" was a link to the tools page. I know it's version specific, but the JDK 25 page should be good enough for a few years :-)
you mean [JDK tools] should be a link to the tools page?
-------------
PR Review Comment: https://git.openjdk.org/guide/pull/167#discussion_r2632258674
PR Review Comment: https://git.openjdk.org/guide/pull/167#discussion_r2632252561
More information about the guide-dev
mailing list