Mais tu vois ce que je veux dire ? 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. Idem pour un point de code qui risque d'être idiomatique plus loin dans le code, ou pour quelqu'un qui connaît le domaine que le code modèle. Par exemple, il m'est déjà arrivé d'écrire un truc du genre (en Perl) :
openmy$fh,'<',$filenameordie"Couldn't open $filename: $!";# this is idiomatic. More info: <url>my$raw;{local$/;$raw=<$fh>;}# do something with full-text-as-string in $raw
Le "slurp" est un idiome qu'on retrouve dans plein de bouquins / articles qui parlent de Perl. Du coup, plein de gens ont même créé une fonction pour « généraliser » le procédé, mais c'est tellement rapide à écrire que la plupart du temps personne ne s'emmerde à faire ça. Comme je savais que des stagiaires auraient peut-être à relire cette partie du code, j'ai rajouté une URL qui explique ce que ça fait, mais c'est vraiment uniquement pour eux que j'ai fait ça. Et je ne le fais que dans le fichier qui sera le plus vraisemblablement ouvert en premier. Dans les autres je ne m'embête pas.
[^] # Re: Traduction faite
Posté par lasher . En réponse au journal Comment devenir programmeur. Évalué à 4.
Mais tu vois ce que je veux dire ? 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. Idem pour un point de code qui risque d'être idiomatique plus loin dans le code, ou pour quelqu'un qui connaît le domaine que le code modèle. Par exemple, il m'est déjà arrivé d'écrire un truc du genre (en Perl) :
Le "slurp" est un idiome qu'on retrouve dans plein de bouquins / articles qui parlent de Perl. Du coup, plein de gens ont même créé une fonction pour « généraliser » le procédé, mais c'est tellement rapide à écrire que la plupart du temps personne ne s'emmerde à faire ça. Comme je savais que des stagiaires auraient peut-être à relire cette partie du code, j'ai rajouté une URL qui explique ce que ça fait, mais c'est vraiment uniquement pour eux que j'ai fait ça. Et je ne le fais que dans le fichier qui sera le plus vraisemblablement ouvert en premier. Dans les autres je ne m'embête pas.