OVH Cloud OVH Cloud

Generer un documentation C# VS 2005

6 réponses
Avatar
B#..
Bonjour a tous,

J'ai encore une fois besoin de vos connaissances :
Je souhaite générer la doc d'un projet fait en VS 2005 Express (C#) .
Je génère le fichier XML adéquat et correct lors du build.
En parcourant le Web, le seul outil que j'ai pu trouver qui était sensé
réaliser la doc est NDOC de sourceForge. Après avoir téléchargé la dernière
version (1.3.1) je ne peux rien générer car il m'annonce qu'il n'est pas
compatible avec le FWK 2.0.
Comment puis-je générer la doc du projet ?

Merci par avance à ceux qui me répondront, et joyeux Noël à tous !!!

B#

6 réponses

Avatar
Delf
B#.. a exprimé avec précision :

J'ai encore une fois besoin de vos connaissances :
Je souhaite générer la doc d'un projet fait en VS 2005 Express (C#) .
Je génère le fichier XML adéquat et correct lors du build.
En parcourant le Web, le seul outil que j'ai pu trouver qui était sensé
réaliser la doc est NDOC de sourceForge. Après avoir téléchargé la dernière
version (1.3.1) je ne peux rien générer car il m'annonce qu'il n'est pas
compatible avec le FWK 2.0.
Comment puis-je générer la doc du projet ?



D'ailleurs, il était possible de le faire sous VS.NET 2003, pourquoi on
ne peut plus sous 2005 ?

--
Delf
Avatar
Michael Moreno
> D'ailleurs, il était possible de le faire sous VS.NET 2003, pourquoi on ne
peut plus sous 2005 ?



Parce que MS a dit que comme NDOC faisait un meilleur job qu'ils ne
l'avaient eux fait, autant laisser la communaute libre continuait... Et
comme la communaute n'a pas suivi on se retrouve a faire des
documentations XML sans pouvoir s'en servir...

--

----------------------------------------------

http://michael.moreno.free.fr/
Avatar
Merlin
Il faut utiliser SandCastle de MS, et pour l'utiliser il existe une
interface qui s'appelle SandCastleGUI.

--

///3rL1n____
Avatar
B#..
Bonjour,

J'ai téléchargé les deux (NDOC et SandCastle).
NDOC fonctionne au poil.
Par contre, J'ai mis en place SandCastleGUI sans pouvoir traiter
correctement la génération de doc : Lorsque je lance cette génération, il
effectue une recopie du SandCastleGUI.exe à l'endroit où j'ai déclaré
vouloir la doc ....!!!
Je me servirais donc de NDOC.

Merci à tous.

B#


"Merlin" a écrit dans le message de news:

Il faut utiliser SandCastle de MS, et pour l'utiliser il existe une
interface qui s'appelle SandCastleGUI.

--

///3rL1n____




Avatar
Merlin
> J'ai téléchargé les deux (NDOC et SandCastle).
NDOC fonctionne au poil.



comme le font remarquer ses promoteurs c'est loin d'être parfait encore
pour .net 2.0. Faut attendre qu'il finisse le portage à mon avis.

Par contre, J'ai mis en place SandCastleGUI sans pouvoir traiter
correctement la génération de doc : Lorsque je lance cette génération, il
effectue une recopie du SandCastleGUI.exe à l'endroit où j'ai déclaré vouloir
la doc ....!!!




Tu verras que dans le répertoire où il se copie il met plein de trucs
qui lui servent de façon temporaire, dont un fichier d'erreur qui
t'explique pourquoi ça n'a pas pu terminer.
En général il s'agit de pb de références.

Je n'ai jamais eu de souci insurmontables avec SandCastle.

Je me servirais donc de NDOC.



si ça génère ce que tu veux, c'est l'essentiel !

Merci à tous.



Happy coding !

--

///3rL1n____
Avatar
gloops
Le vendredi 05 Janvier 2007 à 13:27 par B#.. :
Bonjour,

J'ai téléchargé les deux (NDOC et SandCastle).
NDOC fonctionne au poil.
Par contre, J'ai mis en place SandCastleGUI sans pouvoir traiter
correctement la génération de doc : Lorsque je lance cette
génération, il
effectue une recopie du SandCastleGUI.exe à l'endroit où j'ai
déclaré
vouloir la doc ....!!!
Je me servirais donc de NDOC.

Merci à tous.

B#


"Merlin"

Il faut utiliser SandCastle de MS, et pour l'utiliser il existe une
interface qui s'appelle SandCastleGUI.

--

///3rL1n____







Bonjour,

"NDOC fonctionne au poil."
ça c'est intéressant.

Serait-il possible de savoir de quelle version de NDoc il s'agit, sur quelle version de Visual Studio, et pour documenter un projet développé en quel langage et avec quelle version de .Net ?

Le développement doit être plus ardu qu'il n'y paraît, pour que personne n'ait cherché à mettre les mains dans le cambouis depuis une dizaine d'années.