SoloCodigo

CLR: .Net / Mono / Boo / Otros CLR => C# => Mensaje iniciado por: M4C en Sábado 28 de Abril de 2007, 20:20

Título: Generadores De Documentación
Publicado por: M4C en Sábado 28 de Abril de 2007, 20:20
Hola gente, como va?
Estuve investigando en estos dias herramientas gratuitas para generar documentación a partir de los comentarios de este tipo en el código C#:

Código: Text
  1.  
  2.         /// <summary>
  3.         /// Execute A* algorithm
  4.         /// </summary>    
  5.         /// <param name="_map">Map to look for path</param>
  6.         /// <param name="_diagonalMove">Allows diagonal move</param>
  7.         /// <returns>A serie of movements to find end point</returns>
  8.         public Movement GetPath(Map _map, bool _diagonalMove)
  9.         {
  10.  
  11.              ...
  12.  
  13.  

Necesito que sea capaz de generar documentación HTML minimamente.... si tambien genera PDF, CHM, u otros, bienvenido sea...

Probé NDoc y me pareció que era ideal, el problema es que no se banca código de .Net Framework 2 (yo uso Visual Studio 2005) ... luego probé Doxygen pero realmente tampoco me convenció demasiado.

la pregunta es, ustedes usan algún generador de documentación? me recomiendan alguno? (en lo posible free, que soporte .Net F 2)

gracias!!!
Título: Re: Generadores De Documentación
Publicado por: JuanK en Domingo 29 de Abril de 2007, 17:46
Yo lo he usado asi:

http://blogs.sarkhouston.com/hdierking/arc...09/15/3116.aspx (http://blogs.sarkhouston.com/hdierking/archive/2005/09/15/3116.aspx)
Título: Re: Generadores De Documentación
Publicado por: M4C en Lunes 30 de Abril de 2007, 15:53
lo hice, pero me sigue tirando este mensaje:

Citar
There are no projects in this solution that NDoc can import.

Either the solution is blank, or the projects contained within
the solution are not of a type NDoc can import.

y juro que la solución no está en blanco xD
Título: Re: Generadores De Documentación
Publicado por: M4C en Lunes 30 de Abril de 2007, 21:40
Probé con esta versión y anduvo sin problemas:

NDoc 2 Alpha (http://www.kynosarges.de/NDoc.html)

Si bien no tiene el importador de soluciones de Visual Studio 2005, con el assembly funciona correctamente.

Gracias Juan por la respuesta. Saludos!