On Mon, 24 Feb 2025 13:05:57 GMT, David Beaumont <d...@openjdk.org> wrote:

>> You're right, it looks wrong with the `<h2>` and the @implNote. I'll just 
>> remove the `<h2>`.
>> I hadn't appreciated that the note would have its own section. Thanks for 
>> spotting.
>> It also seems that you can only add one annotation per JavaDoc entry, so I 
>> removed the 2nd.
>
> I've asked on the CSR if this should be @implNote or @implSpec.

Those read more like an @ApiNote, advice on how to use the API.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23491#discussion_r1967859202

Reply via email to