Blog Home  Home Feed your aggregator (RSS 2.0)  
NDoc has died… long live to SandCastle! - Manuel Abadia's ASP.NET stuff
 
# Tuesday, 05 September 2006

The NDoc creators where spending a lot of time with the project with very little (if any) economic reward as it is happening in most open source projects (my personal experience with M.A.M.E. was even worse, because us (the developers) didn’t get a buck but a lot of people outside the team were getting tons of money, illegally selling it in cabinets or creating commercial console (or computer) arcade packs using the MAME source code without permission…) So, they have discontinued NDoc.

As Visual Studio 2005 didn’t come with a documentation generator (as Visual Studio 2003 had) this was a big problem for the dot net community, but Microsoft reacted quickly and created SandCastle, a cool documentation project. The problem is that SandCastle is in beta stage and it doesn’t have any GUI yet so you have to run several executables one after another to get the documentation. You can download the current version here:

http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en

And there is a nice blog about information in how to use the executables to get the documentation done here:

http://blogs.msdn.com/sandcastle

As most people (myself included) don’t want to spent a lot of time and neurons in order to build a CHM documentation file, Eric Woodruff has provided a nice GUI that makes using SandCastle straightforward (and it’s very similar to the one provided by NDoc):

http://www.codeproject.com/useritems/SandcastleBuilder.asp

If you are curious, here you have a screenshot of the generated CHM file using the most common settings:

 SandCastle documentation

And talking about sandcastles… here are two from my visit to Torrevieja (Spain) this summer:

Sandcastle
sandcastle
Tuesday, 05 September 2006 00:58:49 (Romance Daylight Time, UTC+02:00)  #    Comments [0]   ASP.NET | General | Microsoft .NET Framework  | 
Copyright © 2018 Manuel Abadia. All rights reserved.
DasBlog 'Portal' theme by Johnny Hughes.