FxCop ou autre util pour exiger des docs en ligne dans VB.NET?

Question

Je commence un nouveau projet; essayant d'être plus strict que les précédents. J'ai mis des avertissements comme des erreurs dans la construction que j'ai ajouté FxCop à PostBuild. La dernière chose sur ma liste oblige les gens à ajouter des docs en ligne pour toutes les classes/méthodes/propriétés non-privées.

Existe-t-il une règle FxCop personnalisée ou un autre exe que je peux exécuter dans la version post pour vérifier? J'ai du mal à trouver quelque chose, ce qui est surprenant.

Answer 1

Bingo: http://www.ookii.org/software/xmlcommentchecker/

Answer 2

Le compilateur VB.NET ne nous aide pas beaucoup à cet égard que je ne l'ai jamais vu émettre un avertissement pour quelque chose comme <param name="foo">...</param> lorsque vous ne disposez pas d'un paramètre appelé « foo "dans la fonction, mais rien du tout pour les balises manquantes ce qui est ennuyeux. La méthode que j'utilise sur mes projets est d'utiliser le journal de construction de Sandcastle et le grep pour les avertissements qu'il recrache car ils sont faciles à faire correspondre (ils commencent tous par quelque chose comme "Warn: ShowMissingComponent:" et il émettra un avertissement pour toutes sortes de balises manquantes dans votre code.