none
Générer Documentation XML RRS feed

  • Question

  •  Générer Documentation XML

    Bonjour à toutes et tous,

    Je viens d'intégrer une équipe de développement dans laquelle nous travaillons sur un gros projet en C#.
    Le code est bien documenté avec les balises qu'il faut, /// <summary>, etc...
    Je sais générer un fichier XML pour un projet. Propriété du projet => Générer le fichier XML, etc...

    Le problème c'est que la solution contient plus de 200 projets et je me vois mal faire plus de 200 clicks droit, propriétés et tout le tralala et me retrouver ensuite avec 200 fichiers XML.

    Donc ma question, comment générer une documentation complète et facilement, soit avec Visual Studio (2012 Professional), soit avec un autre outil gratuit.

    Merci d'avance,
    Bonne journée.
    GargouilleBL

    mercredi 3 septembre 2014 07:24

Réponses

  • Une solution avec plus de 200 projets : GASP !!!

    Je ne connais pas de solution à votre problème.

    Pour la génération d'une documentation (type html ou chm), vous avez un outil comme SandCastle (développé en interne par Microsoft) mais qui date, n'a pas bcp évolué. Il vous permet à partir des xml de faire votre génération de site de documentation ou un gros chm.

    Mais il faudra bien passer par une étape manuelle pour la génération des xml (et en spécifiant le répertoire ou vous voulez les voir générer). Avec SandCastle (et des projets extensions de SandCastle), vous pourrez les intégrer en un seul projet.

    L'avantage est que vous pouvez aussi intégrer à la build SandCastle (mais il est lent, très lent, alors sur un projet de 200 fichiers, j'ose à peine imaginer)

    Il existe aussi d'autres solutions de génération payantes mais vous passerez tjs par la génération du xml.


    Richard Clark
    Consultant - Formateur .NET
    http://www.c2i.fr
    Depuis 1996: le 1er site .NET francophone

    • Proposé comme réponse Aurel Bera mercredi 17 septembre 2014 10:07
    • Marqué comme réponse Aurel Bera vendredi 19 septembre 2014 06:24
    mercredi 3 septembre 2014 13:06