En fait, je parlais surtout du code, des variables, etc. Les commentaires sont un autre problème.
Ensuite, avoir un code anglais et des commentaires français pose souvent problème ... car on écrit dans le commentaire ce qu'on vient d'écrire dans le code.
Par contre, je nuancerais pas mal ce que tu dis sur les commentaires.
S'il est évident que le code doit être commenté, trop de commentaire pollue le code et au contraire du but recherché alourdis beaucoup le fichier et le rend moins lisible.
Avoir des commentaires trop triviaux est :
- une erreur
- illisible
- inutile
Dans beaucoup de cas, si le code trivial nécessite des commentaires c'est qu'il n'est pas trivial. Et s'il est vraiment trivial le commentaire n'est pas nécessaire, surtout lorsque code et commentaires sont dans la même langue.
En fait, sur un code peu (mais bien) commenté les commentaires sont justement là où il y a quelque chose sur lequel se pencher, là où il y a quelque chose de plus complexe.
Je n'arrive pas à retrouver, j'avais lu une doc sur la manière de commenter un source, disant qu'il en faut à la fois ni trop peu, ni trop.
Polluer le code avec des commentaires ne le rend pas plus lisible, ne pas en mettre est aussi une erreur, après il faut trouver le juste milieu ce qui n'est pas toujours chose aisée.
J'ai aussi lu récemment une prez sur le fait de mélanger vraiment code et commentaires, d'un manière différente de doxygen et consord, mais peu adapté à la POO malheureusement (voir : http://www.roard.com/seaside/pier/publications talk n°3)
[^] # Re: pourquoi ?
Posté par CrEv (site web personnel) . En réponse à la dépêche Le BilboPlanet en version 0.2 est sorti !!. Évalué à 3.
Ensuite, avoir un code anglais et des commentaires français pose souvent problème ... car on écrit dans le commentaire ce qu'on vient d'écrire dans le code.
Par contre, je nuancerais pas mal ce que tu dis sur les commentaires.
S'il est évident que le code doit être commenté, trop de commentaire pollue le code et au contraire du but recherché alourdis beaucoup le fichier et le rend moins lisible.
Avoir des commentaires trop triviaux est :
- une erreur
- illisible
- inutile
Dans beaucoup de cas, si le code trivial nécessite des commentaires c'est qu'il n'est pas trivial. Et s'il est vraiment trivial le commentaire n'est pas nécessaire, surtout lorsque code et commentaires sont dans la même langue.
En fait, sur un code peu (mais bien) commenté les commentaires sont justement là où il y a quelque chose sur lequel se pencher, là où il y a quelque chose de plus complexe.
Je n'arrive pas à retrouver, j'avais lu une doc sur la manière de commenter un source, disant qu'il en faut à la fois ni trop peu, ni trop.
Polluer le code avec des commentaires ne le rend pas plus lisible, ne pas en mettre est aussi une erreur, après il faut trouver le juste milieu ce qui n'est pas toujours chose aisée.
J'ai aussi lu récemment une prez sur le fait de mélanger vraiment code et commentaires, d'un manière différente de doxygen et consord, mais peu adapté à la POO malheureusement (voir : http://www.roard.com/seaside/pier/publications talk n°3)