On Tue, 26 Aug 2025 06:12:38 GMT, Ambarish Rapte <ara...@openjdk.org> wrote:
>> Well, they look very different from the other style. Usually matters of >> style are settled once in a style guide, which we don't have. But I think we >> should at least consciously agree that we're fine with having two different >> styles of documentation in the same project. Personally, I value uniformity >> of style more than the (little) added value that markdown comments bring. > > +1 @mstr2 .. > The markdown style is quite different than traditional HTML base style. With > increased use of markdown, the comments will look very different. We should > keep the uniformity, unless we want to use any feature from markdown style > that is not available in traditional style. 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) ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1873#discussion_r2311445367
