sexta-feira, 15 de agosto de 2008

Documentação em .NET Framework 2.0

Passei alguns dias pesquisando como gerar documentação (formato HTML ou help compilado), através do XML que o Visual Studio 2005 gera. As primeiras versões do NDoc não funcionam para o XML gerado. Finalmente encontrei uma solução para tal problema, lendo o artigo "Visual Studio 2005 - Documentation Generation Using NDoc 2005" [1], indicado pelo colega Alfredo Falcone. Uma das formas disponíveis no artigo, é o uso do NDoc2005 [2]. Este aplicativo, desenvolvido em C#, gera documentação em HTML e/ou help compilado. Caso tenha interesse em gerar a documentação em help compilado, será necessário instalar o Microsoft HTML Help Workshop [3][4], e informar no NDoc2005 a pasta onde o mesmo foi instalado. Segui uma dica mencionada no artigo, e a recomendo: "Ao invés de baixar os binários do NDoc, baixar os fontes, compilá-los e executar src\Gui\bin\Debug\NDocGui.exe".

[1] http://geekswithblogs.net/sudheersblog/archive/2006/07/24/86146.aspx
[2] http://prdownloads.sourceforge.net/ndoc05/
[3] http://msdn.microsoft.com/en-us/library/ms669985.aspx
[4] http://go.microsoft.com/fwlink/?linkid=14188