La Documentation Java - @return et @param

Je me demande comment code de document avec @return et @param ...? Je suis une sorte de deviner que je ferais quelque chose comme

@return(whatever the method is returning)
@param(parameters that the method is taking in)

Aurais-je mettre des descriptions plus par la suite? Aussi, est-il quelque chose comme trop de documentation?

InformationsquelleAutor allyhalcyon | 2014-03-13