On Fri, 27 Mar 2026 00:37:59 GMT, Yasumasa Suenaga <[email protected]> wrote:
> I think it should be do in another issue because it affects all of value > based classes, and also the text is not normalized. That's okay, it's clear we have several cases in the docs where normative and other text that appears after the `@apiNote` makes it appear that the text is part of the API note. On a few occasions I've made to move the custom block tags that are `@apiNote`, `@implNote` .. and the text to the end of the class or method description to avoid the issue. A JEP has been submitted to add "Rish Notes" to API documentation that make help with some of these cases. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/30444#discussion_r2999753567
