05-09-2009, 02:00 AM
J'ai lu ça aussi sur les commentaires, mais j'avais trouvé l'article trop catégorique. Les commentaires sont indispensables, ne serait-ce que pour documenter la signature des fonctions, sauce phpDoc, d'autant plus que PHP n'est pas un langage typé et que quand on lit function getAgadou($maVar, $var2, $blablabla), on connait pas le type des arguments ni celui du retour.
Ensuite, pour ce qui est des commentaires au sein même des fonctions tout ça, je dirais que ça dépend du public qui est susceptible de mettre les mains dans le code source, de la complexité du code. Par exemple si je tombe sur un algo qui fait des calculs sur les bits, vu que j'en fais jamais, je serai un peu paumé et j'aimerais bien avoir des ptits commentaires sur des lignes que "je" trouve complexes. Pareil pour un code source qui utiliserait une extension php, ou une lib exotique. Mais pour le reste, si le code n'a pas été tapé à la gitanos, il est généralement assez parlant pour sa compréhension et il ne raconte que ce qu'il fait
Ensuite, pour ce qui est des commentaires au sein même des fonctions tout ça, je dirais que ça dépend du public qui est susceptible de mettre les mains dans le code source, de la complexité du code. Par exemple si je tombe sur un algo qui fait des calculs sur les bits, vu que j'en fais jamais, je serai un peu paumé et j'aimerais bien avoir des ptits commentaires sur des lignes que "je" trouve complexes. Pareil pour un code source qui utiliserait une extension php, ou une lib exotique. Mais pour le reste, si le code n'a pas été tapé à la gitanos, il est généralement assez parlant pour sa compréhension et il ne raconte que ce qu'il fait