Discussion :

[piotrr]

Visual Studio 2008 permet de générer la documentation xml.
Existe - t - il un outil qui permette de mettre en page simplement ce xml ?

Je voudrai donc un soft qui s'appuie sur la documentation xml générée par VS 2008 pour la mettre en page

merci

[piotrr]

Finalement je me rabats sur l'éxplorateur d'objet de Visual Studio.
Ce qui m'embête c'est qu'il n'est pas exportable.

[Philippe Vialatte]

Si ce que tu cherches, c'st un genre de javadoc, tu as sandcastle

http://philippe.developpez.com/articles/SandCastle

[piotrr]

Oui mais le problème avec sandcastle c'est qu'il fait sa propre interprétation des commentaires.
C'est très long et un petit peu buggé.
Pourquoi ne pas utiliser directement le xml généré par visual studio (même si il n'est pas très propre) ?

Un outil qui prend du xml en entrée, lui applique le bon xsl et on a notre doc html.

Je suis vraiment étonné de ne pas trouvé cela.

[Philippe Vialatte]

Oui mais le problème avec sandcastle c'est qu'il fait sa propre interprétation des commentaires.
C'est très long et un petit peu buggé.

Tres long, oui, ca tourne a une ou deux minutes pour un projet moyen...ceci dit, tu le fais pas tourner a chaque modif

Unpeu bugge, la, je demande plus d'infos . Perso, j'ai une quizaine de projets en ce moment qui utilisent sandcastle pour generer la doc, la doc est generee tous les soirs a 22h, et j'ai eu aucun pb en 2 ans

Un outil qui prend du xml en entrée, lui applique le bon xsl et on a notre doc html.

Sinon, tu as docu:
http://docu.jagregory.com/

(Perso, je le trouve moche, mais...)

[piotrr]

Ce qui est gênant pour l'instant avec sandcastle, et ce doit être un problème de paramètrage, c'est qu'il ne me trouve absolument aucun tag.

Il me ressort tous les objets bien ordonnées j'ai des "Missing" dès qu'il s'agit d'un commentaire (j'utilise les commentaires C#).

Une idée de la propriété à modifier ?

merci

[Philippe Vialatte]

Tu utilise juste sandcastle, ou une interface genre SHFB ?

Si tu n'utilise rien, mais direct Sandcastle a la main, je te conseille de changer de methode (parce que a la main, sandcastle, c'est lourd...)

[piotrr]

Désolé pour cette omission, j'utilise bien sandcastle helpfile builder.

[piotrr]

Je retire ce que j'ai dit sandcastle est un très bon outil. Il faut juste penser à générer le xml dans visual studio.

Sinon je ne comprends pas pourquoi il est aussi long pour générer une documentation Html surtout si le Xml est déjà généré.
Il y a - t - il des paramètres dans Sandcastle Help File Builder qui permettent d'optimiser la génération ?
Cette lenteur serait - elle dût au Xml de Visual Studio qui n'est pas très bien fait ?

[Philippe Vialatte]

Sinon je ne comprends pas pourquoi il est aussi long pour générer une documentation Html surtout si le Xml est déjà généré.
Il y a - t - il des paramètres dans Sandcastle Help File Builder qui permettent d'optimiser la génération ?
Cette lenteur serait - elle dût au Xml de Visual Studio qui n'est pas très bien fait ?

Si je me rappelle bien, la lenteur est du a la phase de linking entre les assemblys et les references

Une optimisation qui fait gagner du temps est de changer SdkLinkType de Msdn a none, pour eviter des requetes a la msdn pour recuperer les references