Re: Grandiose

Ceci dit, la difficulté à maintenir des commentaires nait de la redondance du code, et Java incite à la redondance du code. Exemple :
> en Java :
class Machin {
/**
...
*/
public String truc() {
...
}

/**
...
*/
public String truc(String blah) {
...
}

/**
...
*/
public String truc(String blah, int zorg) {
...
}

/**
...
*/
public String truc(String blah, int zorg, boolean asif) {
...
}
}

> en Ruby :
class Machin
=begin
...
=end
def truc(*args)
...
end
end

Rien que sur ce détail (il y en a d'autres) on est "obligé" si l'on veut bien commenter de se taper plusieurs blocs de commentaires là où un suffirait largement.

Pour inciter un codeur à accompagner son travail de commentaire, il faut qu'il ne se sente pas comme un bon Sisyphe à pousser un rocher qui de toute façon retombe dès que le sommet de la colline est atteint. S'il a l'impression que son travail est inutile, soit parce qu'il pense que son code est déjà limpide, soit parce qu'il voit que de toute façon une fois le code à peine modifié il faut faire trois fois autant de modifications de commentaires, le codeur il n'a pas très envie de commenter.

Oh, je suis sûr qu'il y a des moyens de "gruger" avec Java et de mettre en place du commentaire propre et non redondant, mais je n'ai pas passé beaucoup de temps sur cette plate-forme (ce qui me dérangeait plus que la redondance de commentaires c'est le redondance de code).