Posté par barmic .
En réponse au sondage Les commentaires et vous ?.
Évalué à 4.
Dernière modification le 24 octobre 2013 à 11:27.
Souvent (je n'ai pas dis tout le temps), c'est surtout x qui devrait porter cette information. Si au lieu de l'appeler x, tu lui donne comme nom ce qu'il représente alors tu as déjà au moins la moitié de l'information disponible.
Donc dans ce cas, ce qui me choque ce n'est pas la présence ou l’absence de commentaire mais le nommage de la variable. Une fois qu'elle est nommée correctement tu peut te poser la question de savoir si ce traîner un magic number dans le code est pertinent ou non, enfin si tu garde effectivement le magic number tu peut commenter (si tu ne le garde pas, tu le met dans la conf' du logiciel et tu la documente).
Tous les contenus que j'écris ici sont sous licence CC0 (j'abandonne autant que possible mes droits d'auteur sur mes écrits)
[^] # Re: Code auto-documente
Posté par barmic . En réponse au sondage Les commentaires et vous ?. Évalué à 4. Dernière modification le 24 octobre 2013 à 11:27.
Souvent (je n'ai pas dis tout le temps), c'est surtout x qui devrait porter cette information. Si au lieu de l'appeler
x, tu lui donne comme nom ce qu'il représente alors tu as déjà au moins la moitié de l'information disponible.Donc dans ce cas, ce qui me choque ce n'est pas la présence ou l’absence de commentaire mais le nommage de la variable. Une fois qu'elle est nommée correctement tu peut te poser la question de savoir si ce traîner un magic number dans le code est pertinent ou non, enfin si tu garde effectivement le magic number tu peut commenter (si tu ne le garde pas, tu le met dans la conf' du logiciel et tu la documente).
Tous les contenus que j'écris ici sont sous licence CC0 (j'abandonne autant que possible mes droits d'auteur sur mes écrits)