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, ...

Groovydoc was introduced in 2007 to provide for Groovy what Javadoc provides for Java . Groovydoc is used to generate the API ... Groovy and Java Source Code with Groovydoc/Javadoc Comments.

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.