Skip navigation

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.

6 Comments

    • Régis
    • Posted 13 mars 2008 at 16:07
    • Permalink

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

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

    • serioussam
    • Posted 14 mars 2008 at 9:56
    • Permalink

    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 !

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

  3. « 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 !

    • Seb
    • Posted 23 décembre 2009 at 20:28
    • Permalink

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


2 Trackbacks/Pingbacks

  1. By Sexy Coders » Fierté de notre blog on 25 juil 2008 at 9:33

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

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

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Vous pouvez utiliser ces balises et attributs HTML : <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>