22 votes

Outil alternatif pour un outil de type GhostDoc

Existe-t-il un outil pour .NET qui génère des explications (commentaires) du code si nous lui donnons des gestionnaires de fonctions ou d'événements (comme GhostDoc qui, selon nous, n'est pas un bon outil) ?

20voto

Mrchief Points 25418

En fait, /// ne génère aucune documentation, seulement des balises XML vides. Là où GhostDoc brille, c'est en générant automatiquement une documentation de type MSDN (y compris le verbiage), sur la base d'informations contextuelles telles que la propriété, la classe, la visibilité, l'utilisation, etc.

Voici quelques vraies alternatives :

  • Atomineur (un peu moins cher que GhostDoc)
  • Resharper (ne fonctionne que si vous activez les commentaires XML pour le projet, mais est loin d'être aussi bon que les deux précédents. peut également copier les commentaires XML des classes/interfaces de base).

Quoi que vous fassiez, ne produisez pas non-documentation ! :)

15voto

dotalchemy Points 1682

Si vous commencez un commentaire par /// dans VS2010, il créera des paramètres de base en XML pour vous en fonction de la fonction que vous commentez.

http://msdn.microsoft.com/en-us/magazine/dd722812.aspx

Ainsi, en tapant /// avant la fonction startMonitor(ManagementScope scope) donne...

/// <summary>
/// 
/// </summary>
/// <param name="scope"></param>
static void startMonitor(ManagementScope scope)

Si vous souhaitez générer une documentation décente à partir de ces documents, je vous suggère de procéder comme suit https://github.com/EWSoftware/SHFB comme première étape. C'est un vrai régal.

2voto

Paul Sasik Points 37766

Jetez un coup d'œil à Château de sable . Il fonctionnera avec les projets Visual Studio 2005. Des téléchargements sont également disponibles pour nDoc . Il a connu son heure de gloire vers 2005, mais je pense qu'il n'y a eu que peu ou pas de développement depuis.

Si vous cherchez quelque chose qui va réellement pré-remplir les commentaires de code pour vous, je ne suis pas sûr que vous puissiez faire beaucoup mieux que GhostDoc.

2voto

Il n'y a même pas un seul cas sérieux GhostDoc Alternative

J'espère que j'en lancerai un autre moi-même très bientôt.
PS : merci de m'informer si vous trouvez une difficulté, une erreur ou un nouveau problème.

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X