Indeed, I really dislike java doc style of documentation which forces you to explicitly state a short description, then parameters and then a return value. For

Indeed, I really dislike java doc style of documentation which forces you to explicitly state a short description, then parameters and then a return value. For many simple functions a return value documentation which mentions the parameters would be amply sufficient.