Tool for generation MSDN-like documentation from <summary> tags?

Question

Does anyone know any tool like NDoc that could generate MSDN-like documentation out of XML comments in the C# code? I need it for .NET 3.5 and C#.

Sandcastle maybe?

Thanks.

Answer 1

Yep, SandCastle.

NDoc was abandoned, unfortunately.

Answer 2

I am currently using NDoc, but it is no longer maintained. I hear Sandcastle is the way forward, but it may not be very stable/full featured yet.

Answer 3

SandCastle comes from what they use internally at Microsoft, I believe. I have used it in the past to generate documentation for our code which looked very similar to MSDN.

Answer 4

I just installed and tried Sandcastle.

I also found Sandcastle Help File Builder as a GUI interface.

But, I have a problem... I have a assembly which referenced Microsoft Enterprise Library. When I generate documentation for my assembly, it also generated the documentation for the referenced EntLib...

I'm still playing with it, but do you know how to turn this off, and generate documentation just for my assembly?

Answer 5

I've done this recently, but I can't remember the exact steps.

I think I added the external assemblies as dependencies, rather than as actual project assemblies. Let me know if this works. If not I'll do some more digging.

ZS

Answer 6

@mmilic

I'm still playing with it, but do you know how to turn this off, and generate documentation just for my assembly?

Yes you can. Add EntLib through the Dependencies property. You can see it on the Build category.

Answer 7

Thanks guys, that was it.

All I needed to do was add my referenced assemblies to the Dependencies property and that was it.

By the way, do you know how could I generate MSDN style documentation? The best example is the one used in Visual Studio. It is browsed with the Document Explorer.

I'm currently generating HtmlHelp 1.0 (.chm) files, which is also fine...

Answer 8

Doxygen now supports the XML formatted commands, including You can also use the other Doxygen commands to add information that the default XML comments don't support in the standard.

Answer 9

Hello,

See procedure to generate MSDN-like documentation here : http://www.maverick-zone.fr/index.php?page=tuto&amp;id=15 (French)