« Programmation Java/Commentaires » : différence entre les versions

Contenu supprimé Contenu ajouté
 
Ligne 6 :
 
Il est utile pour expliquer ce que fait le code source :
* expliquer comment utiliser la classe / la méthode correctement, à quel moment, avec quels types de paramètres, etc. ;
* expliquer le choix technique effectué : pourquoi tel algorithme et pas un autre, pourquoi appeler telle méthode, pourquoi telle valeur pour la constante, etc. ;
* expliquer ce qui devra être fait par la suite (liste de chose à faire) : amélioration, problème à corriger, etc. ;