Sommaire

L’analyse des commentaires de code Analyse:des commentaires de codes

L’analyse des commentaires de code n’est pas un domaine très étudié dans la littérature logicielle. Il est, en effet, souvent considéré que les commentaires ne sont pas des instructions, mais du texte neutre et qu’ils ne peuvent donc pas générer ou participer à de quelconques problèmes logiciels. Les commentaires sont écrits en langage naturel et sont donc, comme tout texte, difficiles à comprendre et à analyser. C’est pourquoi il n’existe pas, dans le commerce, de logiciels capables d’analyser les commentaires d’un code source et de repérer les éventuels problèmes qu’ils soulèvent.

Pourtant, certains problèmes peuvent être détectés par une simple analyse automatique du code source : le code non terminé, le code maquette, les doutes du programmeur, les problèmes signalés, mais pas corrigés, les codes open source utilisés, les commentaires qui ne sont pas en anglais, les commentaires déplacés ou les grossièretés et bien sûr le calcul d’un ratio code/commentaires permettant de quantifier réellement la documentation du code source. Dans cette optique, j’ai créé un logiciel d’analyse des commentaires dans plusieurs langages et permettant de détecter ces problèmes potentiels.

Le code non terminé ...