Technorati Tags: Sandcastle,.NET Photo credit: cynwulf I'm of the opinion that in-line comments are often a "code smell", but if you're developing a framework or class library that you want others to use, .NET XML comments on public classes and members used to generate documentation can be very useful. The tool for building that documentation is Sandcastle. According to its CodePlex site, "Sandcastle produces accurate, MSDN style, comprehensive documentation by reflecting over the source assemblies...
This week, the lead developer on a major open source project, NDoc, resigned. His reasons are valid, if not disappointing (not in him, in the community of NDoc users), but that's not the point. Coming on the heels of this announcement is the announcement about the pending availability of Sandcastle.What's Sandcastle? Well, the preliminary announcement is a little light on details, but there's a few tidbits that give you a clue that it could be a replacement for the now defunct NDoc: Produces MSDN-like...