Re: Traduction faite

Pour moi, les commentaires sur les structures de données, ou bien qui précèdent la définition d'une fonction sont une pratique saine.

Tant que le commentaire est justifié, ok.

Et je n'ai pas dit que c'était à bannir dans tous les cas (c'est fou le nombre de gens qui lisent trop vite sur linuxfr...)

Mais les commentaires c'est pas gratuit. Faut les maintenir. Bien les écrire, etc. ...

Si on peut avoir un code plus clair qui se passe de commentaire (pas toujours possible évidemment, mais c'est un but à avoir), c'est mieux.

Et ce qui est beaucoup trop commun, c'est le mauvais commentaire.

Celui qui dit le contraire du code (car il n'a pas été mis à jour)
Celui qui ne veut rien dire.
Celui dans lequel son auteur passe sa colère plutôt que de documenter le code
Celui qui répète le code
Celui qui est du code commenté alors qu'on a des gestionnaires de version pour retrouver l'ancien code
Celui qui n'est que confettis :

#############################
# SUPER PROGRAM !! #
#############################

Celui qui met uniquement le nom de l'auteur (on s'en fout un peu)
Celui qui met un copyright "machin" alors que c'est pas justifié (pour faire style, quoi)
Celui qui est un TODO oublié depuis longtemps et obsolète
etc ...

Je sais pas, je dois être le seul a être tombé sur du code pourri agrémenté de commentaires pourris pour relever un peu le goût ?

"Quand certains râlent contre systemd, d'autres s'attaquent aux vrais problèmes." (merci Sinma !)