Génération de la documentation C# sans créer de document Xml

Question

Tout d'abord, j'ai vu Generating Documentation from C# XML Comments et bien d'autres similaires, mais aucun des outils proposés ne fonctionne pour ce dont j'ai besoin.

J'ai besoin d'un outil gratuit qui peut générer de la documentation (de préférence en HTML) à partir de mon code source sans utiliser le document XML créé par Visual Studio. Le projet a des avertissements en tant qu'erreurs activées et en vérifiant l'option de générer ce fichier xml crée des centaines d'erreurs. En effet, cela exclut 90% des générateurs de documentation C#, y compris Sandcastle, NDoc3, Live Documenter, docu et ImmDoc.

Doxygen fonctionne presque, mais je ne peux pas sembler l'obtenir pour générer la documentation pour les classes génériques surchargées, telles que:

public class MyClass<Foo> 
public class MyClass<Foo, Bar> : MyClass<Foo> 

MyClass dispose d'une documentation, mais MyClass ne fonctionne pas.

Alors la question - est là:

1. un générateur de documentation que je ne l'ai pas vu qui peut gérer ce cas,
2. une option de configuration dans l'un des outils que j'ai énumérés qui ferait il fonctionne sans exiger le fichier xml-documentation,
3. ou même un moyen de désactiver juste les avertissements du compilateur de commentaire sans affecter les avertissements de construction?

Modifier. Une solution au moyen de la méthode n ° 3 consiste à supprimer les avertissements suivants relatifs aux commentaires xml: 1570, 1571, 1572, 1573, 1574, 1580, 1581, 1584, 1587, 1589, 1590, 1591, 1592, 1598, 1710, 1711, 1712, 1723

Answer 1

Vous pouvez désactiver warning 1591 dans Propriétés du projet, puis générer le code XML.