News for hackers. Stuff that matters.
Re:On Markdown in Java documentation comments by taftster on Tuesday January 24, 2023 @12:16PM (#34506654)
Agreed. While I read javadoc for the core SDK and other common libraries, it's very rare that I need to read it for my own (or company's) repositories. Instead, I'm just reading the source code and the javadoc embedded in each source file.

HTML inside of javadoc is very awkward. I hardly ever use it unless I know I'm going to be generating javadoc for a published library. Instead, I'm just already putting markdown-like formatting in the comments already.

There are no comments on this comment yet.