http://ayende.comAyende @ RahienCopyright (C) Ayende Rahien 2004 - 2021 (c) 202660About a year ago I was using DocProject, [http://docproject.codeplex.com/](http://docproject.codeplex.com/). It installs VS template which you can use to create the project and integrates into msbuld quite nicely. http://ayende.com/4635/generating-api-documentation#comment9http://ayende.com/4635/generating-api-documentation#comment9Thu, 23 Sep 2010 05:46:41 GMTMatt, Thanks, that took over 2 minutes from the help build time http://ayende.com/4635/generating-api-documentation#comment8http://ayende.com/4635/generating-api-documentation#comment8Tue, 21 Sep 2010 07:25:39 GMTThis is something that's puzzled me for a while - Why .NET does not have a standard document generator. Ruby has RDoc. I too tried Sandcastle a couple of years ago but gave up as well. It's not a product but a set of (very raw) tools - it's just too much hard work to use. Doxygen on the other hand is good, but is not .NET specific, and does not seem to cope with all edge cases in .NET. Maybe the thought of building Rhino.Doc isn't such a bad idea ??? http://ayende.com/4635/generating-api-documentation#comment7http://ayende.com/4635/generating-api-documentation#comment7Tue, 21 Sep 2010 00:07:02 GMTAnother vote for Document X - the other nice thing is that you can put topics other than straight API stuff http://ayende.com/4635/generating-api-documentation#comment6http://ayende.com/4635/generating-api-documentation#comment6Mon, 20 Sep 2010 15:17:18 GMTYou didn't try Document! X? It's commercial, true, but gives the least # of friction (although VSDocMan also looks nice) as in: you don't have to spent extra time when writing code. http://ayende.com/4635/generating-api-documentation#comment5http://ayende.com/4635/generating-api-documentation#comment5Mon, 20 Sep 2010 14:40:59 GMTWhat?! No Rhino.Doc? (Sorry, I know the joke is getting old.) We settled on Doxygen for Caliburn (though I believe that was two years ago). http://ayende.com/4635/generating-api-documentation#comment4http://ayende.com/4635/generating-api-documentation#comment4Mon, 20 Sep 2010 13:30:34 GMTHi Ayende With Sandcastle, you can speed up the build substantially doing the following: Click on the "ComponentConfigurations" properties button, and add "Cached Framework Comments Index Data", "Cached MSDN URL References", and "Cached Reflection Index Data". HTH, Matt http://ayende.com/4635/generating-api-documentation#comment3http://ayende.com/4635/generating-api-documentation#comment3Mon, 20 Sep 2010 13:29:17 GMT"I didn’t know whatever you can easily put it in a build script." The saved file output from the Sandcastle Help File Builder is an MSBuild-based project file, so it should integrate well with a build script. http://ayende.com/4635/generating-api-documentation#comment2http://ayende.com/4635/generating-api-documentation#comment2Mon, 20 Sep 2010 12:58:14 GMT" it gave me an error there as well, something about duplicate mscorlib," Could be you need to bump up the tools version in the csproj. 2.0 tools don't know how to build 4.0 projects so they always pull in the old mscorlib. http://ayende.com/4635/generating-api-documentation#comment1http://ayende.com/4635/generating-api-documentation#comment1Mon, 20 Sep 2010 10:17:34 GMT