En règle général il vaut mieux éviter les commentaires dans le code, à la place écrivez du code auto-explicatif (nom des variables, des fonctions)

À l'intérieur des fonctions, les (rares) commentaires doivent donner des informations de contexte impossible à deviner.

Les commentaires restant doivent de préférence être en en-tête des fonctions et très bien rédigés pour être vraiment utiles.