On Mon, 1 Sep 2025 21:16:16 GMT, Nir Lisker <[email protected]> wrote:
>> I think markdown style is ok, since it results in a more readable source. >> >> The support in other tools might be lacking initially (for example, Eclipse >> does not refresh its javadoc pane with markdown as it does with the usual >> style) > >> Eclipse does not refresh its javadoc pane with markdown as it does with the >> usual style > > Was fixed months ago in > https://github.com/eclipse-jdt/eclipse.jdt.ui/pull/2051. Not sure if a stable > version was released yet. I started a (belated) [discussion on this on the mailing list](https://mail.openjdk.org/pipermail/openjfx-dev/2025-October/056578.html). As mentioned in that message, I think using markdown comments is fine for new APIs and docs that are modified in a way that markdown would be helpful. ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1873#discussion_r2399568312
