Hace tiempo leí en el blog de Jorge Serrano, una herramienta de Microsoft para generar documentación de un proyecto Visual Studio 2005. La herramienta en cuestión se llama SandCastle y despues de instalar y probarla, la verdad es que me ha sido muy útil.
Sin embargo, es una herramienta de línia de comandos, con lo que no incluye un IDE. Como era de esperar existen varias alternativas al respecto y me quedé con uno, de Eric Woodruff, el cual ofrece un IDE muy similar a NDoc y muy sencillo de utilizar.
Los resultados... estupendos!!! El único inconveniente ha sido que al establecer la propiedad SdkLinkType a MSDN, para que consuma los WebServices del mismo, y al requerir salida a Internet mediante proxy me generaba un error tal que:
Info: ResolveReferenceLinksComponent: Preparing to query MSDN topic URL web service.
Error: ResolveReferenceLinksComponent: An error occured while attempting to query the MSDN topic URL web service. The error message is: Error de la solicitud con el c¢digo de estado HTTP 407: Proxy Access Denied.
Last step completed in 00:00:46.6418
La solución (notificada por Eric W) es crear el archivo BuildAssembler.exe.config al mismo nivel que BuildAssembler.exe con la siguiente información que encontrareis en este post.
Suscribirse a:
Enviar comentarios (Atom)
No hay comentarios:
Publicar un comentario