The best code documentation generator for .VS 2005?

[woojtii]

Hello,

what is the best code documentation generator for .VS 2005?


Is it NDoc for VS.NET 2005 the best, or you know better alternatives?


Thank you for suggestions

 

[PlausiblyDamp]

NDoc still has issues with some of the .Net 2 constructs (generics being one of them), although development is still happening and apparently a new version is in the works.

There are other documentation tools out there but none that are free (or I haven't seen any so far).

 

[mskeel]

I've been struggling with trying to find .Net 2.0 version of NDoc for quite a while now. So long as you aren't using generics in your code, you can generate documentation for 2.0 using the old NDoc if you modify some config files. You can find out how to do that by going through some of the discussion threads on the sourceforge page for NDoc.

NDoc is pretty sweet, though I'd be interested to see other free/open tools that are out there.

 

[PlausiblyDamp]

Digging up an old thread here but http://www.sandcastledocs.com/Wiki Pages/Home.aspx is looking good, especially when used with a GUI like http://www.sandcastledocs.com/Wiki Pages/Sandcastle GUIs from Community.aspx (which can even import existing ndoc projects).

 

[mskeel]

To link the threads...

http://www.xtremedotnettalk.com/showthread.php?t=97035&highlight=sand+castle

I thought I had posted about sandcastle on this forum somewhere before. It's good to see development coming along. A month ago sandcastle was a hard beta. Thanks for posting this up, PlausiblyDamp. It's hard to stay on top of all the various tools that are out there.