Effectivement, de tels commentaires ne sont franchement pas terribles.
Certains commentaires sont inutiles, par exemple:
ou
Code : Sélectionner tout - Visualiser dans une fenêtre à part // affecte les propriétés
Les commentaires d'en-tête sont loin d'être complet (la plupart sont essentiellement de simple paraphrase des noms de fonction/paramètres sans spécifier les conditions d'utilisation, le codage des paramètres, etc. Bref pas très utile en l'état), par exemple:
Code : Sélectionner tout - Visualiser dans une fenêtre à part // Imports de la classe
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6 /** * Retourne un cadre selon son index. * @param i l'index du cadre à retourner * @return le cadre selon l'index fourni */
Partager