Je trouve que l'exemple que tu donne pour la documentation n'est pas de la documentation inutile. Ça montre que c'est uniquement un getter et qu'il n'y a pas d'effet de bord par exemple, chose qui ne serait pas possible de savoir si ce n'était pas indiqué. Et comme la doc, c'est aussi lu quand on ne voit pas le code, c'est intéressant.
« Rappelez-vous toujours que si la Gestapo avait les moyens de vous faire parler, les politiciens ont, eux, les moyens de vous faire taire. » Coluche
# La doc est toujours utile
Posté par claudex . En réponse au journal De tout, de rien, des liens, bla bla bla. Évalué à 3.
Je trouve que l'exemple que tu donne pour la documentation n'est pas de la documentation inutile. Ça montre que c'est uniquement un getter et qu'il n'y a pas d'effet de bord par exemple, chose qui ne serait pas possible de savoir si ce n'était pas indiqué. Et comme la doc, c'est aussi lu quand on ne voit pas le code, c'est intéressant.
« Rappelez-vous toujours que si la Gestapo avait les moyens de vous faire parler, les politiciens ont, eux, les moyens de vous faire taire. » Coluche