OVH Cloud OVH Cloud

Générateur de documentation

2 réponses
Avatar
Stéphane ANDRE
Je ne comprends pas.

J'ai un projet C# classique avec des balises de documentation <summary>
</summary> et quand je génère la documentation je n'ai que la page web
principale mais les autres ne sont pas générées.

Il y a t-il quelque chose de particulier à vérifier.

Si une balise est incorrecte n'y a t-il pas un moyen de la détecter ?

Merci d'avance.

2 réponses

Avatar
Ambassadeur Kosh
> J'ai un projet C# classique avec des balises de documentation <summary>
</summary> et quand je génère la documentation je n'ai que la page web
principale mais les autres ne sont pas générées.



utilisez NDoc. ça, c'est un vrai outils.

Il y a t-il quelque chose de particulier à vérifier.



pas que je sache.

Si une balise est incorrecte n'y a t-il pas un moyen de la détecter ?



le compilateur le fait pour vous. c'est une option a activer. il vous dira
meme par exemple, que tel balise parameter designe un parametre qui n'existe
plus, que telle methode public n'est pas documentée etc etc...
Avatar
Paul Bacelar
Avec FXCop, on peut aller jusqu'à vérifier la pertinence et la complétude
des commentaires.

http://msdn.microsoft.com/msdnmag/issues/04/09/Bugslayer/
--
Paul Bacelar

"Ambassadeur Kosh" wrote in message
news:uVd#
> J'ai un projet C# classique avec des balises de documentation <summary>
> </summary> et quand je génère la documentation je n'ai que la page web
> principale mais les autres ne sont pas générées.

utilisez NDoc. ça, c'est un vrai outils.

> Il y a t-il quelque chose de particulier à vérifier.

pas que je sache.

> Si une balise est incorrecte n'y a t-il pas un moyen de la détecter ?

le compilateur le fait pour vous. c'est une option a activer. il vous dira
meme par exemple, que tel balise parameter designe un parametre qui


n'existe
plus, que telle methode public n'est pas documentée etc etc...