Te refieres a lo que se conoce como Javadoc
Puedes agregar comentarios antes de la declaración de tu método con los contenedores /**
y **/
Despues de agregar los comentarios puedes ir a Tools
> Generate JavaDoc
para generar la documentación de tu aplicación.
https://www.jetbrains.com/help/idea/2016.3/generate-javadoc-dialog.html
https://www.jetbrains.com/help/idea/15.0/viewing-inline-documentation.html