Dans la série des outils à installer absolument, voici « Ghostdoc » :

Il permet d'automatiser partiellement la l'écriture des commentaires, que du bonheur…

Au passage, voici la config d’un projet pour forcer les gens à mettre des commentaires :

Avec cela, on a une erreur de compilation si un commentaire est manquant. (A mettre en place au début du projet)