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