Hat en ezektol hisztit kapok pl.:
/** adds two integer numbers to a given instance
* @param instance_id The instance of the given id
* @param number_a The first number to add
* @param number_b The second number to add
*/
public void addTwo(ID instance_id, int number_a, int number_b){
...
}
Mindig azt szoktam mondani, hogy ez itt szep, de a meghivas helyen nem lesz ott, nyilvan az IDE majd kirakja mouseoverre, de ettol meg ha adna neki egy ertelmes nevet, akkor olvashato lenne a dolog anelkul is.
Ha kotelezove teszed a kommentelest a programozoknak, azok Mr. Obvious kommenteket fognak irni, es volt mar nem egyszer, hogy 120 oldalas api-doksiban egyetlen dolog nem volt obvious, de az is ugyanugy volt talalva mintha az volna.