[RESOLVED] [2005] Documentation

[MaslowB]

Does anyone know of any tools that you can point at a project or the xml generated with its DLL to build you a template for documenting the project?

If not I'm thinking of trying to read the XML into a tree view, since the +/- buttons to expand and contract detail on something would be tremendously helpful for large libraries. The other thing I was considering was an XSLT to lay on top of a webpage.

I'm ok with XML, but not great with utilizing it in VB, so this would be good practice/learning.

Thoughts?

[gep13]

Hey,

Unless I have misunderstood your request, you might want to look at the following:

Sandcastle
NDoc

Hope this helps!!

Gary

[MaslowB]

both of those look like a fairly good solution, however NDoc just throws exceptions as it doesn't support .net 2.0 or newer. trying sandcastle now.

[MaslowB]

Sandcastle Error: SyntaxComponent: The type 'Microsoft.Ddue.Tools.ScriptSharpDeclarationSyntaxGenerator' does not exist in the assembly 'C:\Program Files\Visual Studio 2005 SDK\2007.02\VisualStudioIntegration\Tools\Sandcastle\\ProductionTools\SyntaxComponents.dll'.
This is almost the last step the buildAssembler step.

[MaslowB]

Thanks to the nicely informative error messages and FAQ in Sandcastle Help File Builder, it appears I have auto-built documentation for my biggest library in 3 different formats. My boss is satisfied, I don't have to write manual documentation, WEEEEE.

[gep13]

Woot Woot!!

[MaslowB]

Marked resolved, and rated. thanks.