Java documentation comments traditionally use HTML and JavaDoc tags, a practical choice in 1995 but has since become less convenient. HTML is verbose and challenging to write by hand, ...

In Java, you can use the comment feature to embed documentation in your source code. A comment is a delimited block of text that’s meaningful to humans but not to the compiler.

There is a lot to dislike with comments (don’t get me started on the actual things being said) but they can be effective for conversation, especially with the addition of threaded / nested comments.