Partage via

Règles de documentation

  • Article

Les règles de documentation prennent en charge l’écriture de bibliothèques bien documentées par le biais de l’utilisation correcte des commentaires de documentation XML pour les API visibles en externe.

Contenu de cette section

Règle Description
CA1200 : Évitez d’utiliser des balises cref avec un préfixe L’attribut cref dans une balise de documentation XML signifie « référence de code ». Il spécifie que le texte interne de la balise est un élément de code, tel qu’un type, une méthode ou une propriété. Évitez d’utiliser les balises cref avec des préfixes, car elles empêchent le compilateur de vérifier les références. Il empêche également l’environnement de développement intégré (IDE) visual Studio de rechercher et de mettre à jour ces références de symboles pendant les refactorisations.