06-06-2010, 03:48 PM
Dans ce cas, faire un encadrement, rappeler le prototype de la fonction, etc. n'est pas forcément utile. :p
Dans ton exemple, je dois avouer que le commentaire obscurcit plus le sens du code qu'il ne le clarifie : le nom de la méthode suffit, d'autant que c'est une fonctionnalité du framework déjà documenté.
Et puis… Ça craint un peu comme filtres, face aux originaux.
Sephi-Chan
Dans ton exemple, je dois avouer que le commentaire obscurcit plus le sens du code qu'il ne le clarifie : le nom de la méthode suffit, d'autant que c'est une fonctionnalité du framework déjà documenté.
Et puis… Ça craint un peu comme filtres, face aux originaux.
Sephi-Chan