Visual studio 2008 html project documentation

Question

hi there, i read a lot of threads on stackoverflow regarding the documentation production under visual studio.

i went on sandcastle website but i'm not sure it is what i'm looking for. I'm trying to produce a website msdn stile where my team can find project documentation. Visual studio allow to create xml files but next step still miss: creation of html structure from xml files.

any tips?

Answer 1

Check this link : C# XML Comments Let You Build Documentation Directly From Your Visual Studio .NET Source Files

Example of how the documentation will look with style

Answer 2

Sandcastle is the Microsoft-made documentation generator, but you need a front end for it. I prefer DocProject myself: DocProject on CodePlex

It integrates into Visual Studio and lets you manipulate the output in a pretty reasonable manner. The output is supposed to be "MSDN style" and you get a couple of choices for themes. Unfortunately no choice for the awesome new "lightweight" theme.

The DocProject site has fairly thorough documentation and will walk you through everything.

Beware, the actual documentation generation operation is pretty resource heavy regardless of how you use Sandcastle.