Last week I received an email from one of my clients asking for latest help documentation for HTMLParser.Net library. Then I realized it has been couple of years since I updated documentation for that library. I used to use NDoc for generating help files. Since .Net2.0 that project has been abandoned. And then Microsoft introduced Sandcastle project. Initially it was buggy to the extent that it used to crash all the time when I generated documentation for my library. So I kind of abandoned it. Last night I went back to Sandcastle site and was glad that the project is still alive is being updated regularly. So I decided to give it a try. Well it still has some bugs and still crashed on my library. But this time I was able to follow the error stack trace and figure out what area may be giving it trouble. It turned out that my XML comments had some text that was colliding with some XML reserved keywords. After removed that, it worked like a charm. So if you are thinking of generating help file for your .Net class library, here are some simple steps that you can follow:
If you have any questions about usage feel free to drop me a line.