not sure whether to use Sandcastle, NDoc, or both

Apr 11, 2009 at 12:14 AM
Hello ... I seemed to have discovered two tools that perform the same task:
              Sandcastle is one; Ndoc the other.  I think both are free but am not sure about that.

Any reason to use one instead of the other?

What are the pros and cons of each?

Does anyone use both for whatever each is best at?

Thank you.


P.S.:  I'm using vs2008 Pro and .Net 3.5 and ASP.NET MVC v1.0.

May 8, 2009 at 11:07 AM

Is there an NDoc version for .Net 3.5?

May 8, 2009 at 4:04 PM

There's an NDoc version for .NET 2.0 floating around out there somewhere.  Google could probably help you find a copy.  Since .NET 3.5 is built on top of .NET 2.0, it would most likely work with .NET 3.5 assemblies.  However, getting support for NDoc if you do run into problems could prove difficult.  I think you'll find that support for Sandcastle and the various community tools related to it is much better.




May 8, 2009 at 7:01 PM

I know only this one:


But this doesn't work with .Net 3.5.

May 12, 2009 at 12:46 PM

I'd rather not use NDoc for new projects - NET 2.0 support is completely unofficial (especially generics are not supported really well) and the code is basically unmaintained. While the complexity of sandcastle may be a bit overwhelming, I think it's the much better choice, especiall combined with tools like SHFB.