Les commentaires doivent servir à expliquer le code, et non pas expliquer le langage de programmation.

- il ne faut pas mettre du code en commentaire, "en guise de backup" car dans 6 mois quand un collègue viendra débugger il ne comprendra plus rien et s'interessera à ce bout de code en commentaire en croyant y trouver une solution

exemple

- si on utilise un outil de gestion de code source , il ne faut pas mettre en commentaire des infos de date et de personnes:

exemple

Autre usage des commentaires : pour expliciter et diviser le code en section

Exemple en début de fichier

des formats standards à respecter pour générer de la doc de classe automatiquement, qui décrivent les paramètres attendues et le retour.

Les commentaires peuvent être utilisé pour mettre en forme un fichier, pour le rendre agréable à lire.

mettre en forme le fichier :

Code propre, clair, limpide. Facile à modifier relire dans 5 mois. N'a pas nécessité 5 heures à être mis en place. Simplement en lisant les commentaires on comprend.

Attention à ne pas en faire trop sur la présentation, sinon ça gène aussi.

Une petite notre pour finir : d'expérience il est préférable d'utiliser // à /* pour la raison suivante: lors de debug, il n'est pas rare de devoir mettre en commentaire un bloc de code donc rapidement