Pourquoi ne pas commenter son code?

Coder comme un sexy-coder?… Ce n’est pas donné à tout le monde. Mais voici un tuyau pour commencer: ne pas commenter son code. 

Seuls les noobs commentent leur code. Quand le noob écrit un tuto sur internet, il donne comme conseil de bien commenter. Vous rencontrerez peut-être des textes écrits par ces débutants, contenant des phrases du genre: “Commentez votre code, pour les autres mais aussi pour vous!”. /!\  ATTENTION /!\  C’est typiquement le genre de conseil qu’il faut éviter. L’auteur insinue que vous pouvez vous permettre d’écrire du code incompréhensible. Il vous suggère d’écrire en français ce que le code fait. Plus particulièrement, c’est une honte de proposer de commenter un langage de gay.

Je lis beaucoup de code. J’imprime régulièrement du code pour lire avant de me coucher. Je dirais que 93% des commentaires dans les codes ne servent à rien. Que penser d’un programmeur qui écrit:

} else if (r==3){          // autre cas..

?

Le codage passe parfois par des longues séances de débuggage. Dans des situations comme ça, les commentaires n’apportent pas non plus beaucoup de clarté:

//calcul total charges de personnel
//(on a besoin de personne en harley davidson)
$this->i_totalFraisPersonnel = $personnel->get_Total_ChargesPersonnel();

Et le peu de commentaire qui reste sert à expliquer l’algorithme. Or, vous savez depuis que vous lisez sexycoders.com qu’un code parfait se lit tout seul, s’explique tout seul, le code se transforme en prof et vous explique comment il fonctionne. C’est pas les commentaires qui expliquent le code, c’est le code lui-même.

Ne commentez plus. Vous écrirez de meilleurs codes.

8 Comments so far

  1. Régis on mars 13th, 2008

    Au moins ça montre que vous savez écrire du texte en français.

  2. very on mars 14th, 2008

    D’ailleurs la nullité du code est souvent proportionnelle à la longueur des commentaires..

  3. serioussam on mars 14th, 2008

    C’est surtout une garantie pour conserver ton emploi plus tard : fais du code non commenté, si possible avec des variables non explicites, et tu seras le seul à pouvoir le maintenir : emploi à vie garanti !

  4. Flo on mars 16th, 2008

    ouai et si tu obfusque ton code tu augmente tes chance de rester aussi :D

  5. Sexy Coders » Fierté de notre blog on juillet 25th, 2008

    [...] On vous a expliqué comment écrire du code parfait, on vous a expliqué ici pourquoi ne pas commenter son code. [...]

  6. mr-bark on octobre 1st, 2008

    “si on veut encore plus de jeux qui rament, on peut telecharger en payant” … point dedétail très important ;) meri pour ce billet ! continue !

  7. [...] Je vais bien entendu omettre de lui enseigner les commentaires dans le code pour de raisons évidentes. [...]

  8. Seb on décembre 23rd, 2009

    J’espere qu’on bossera jamais dans la même boite….

Leave a reply