Sandcastle - MSDN-style docs for your assemblies

For a *long* time, whenever I spent time with C# customers, I would invariably get asked, "How do I create docs for my assemblies?".

And my best answer was either, "there's a XSLT file that makes the XML look a little better" or "you might want to consider NDoc".

Neither of which was a great answer. The XSLT was quite inferior to what people wanted, and NDoc also had limitations.

That issue was not unnoticed inside MS, but it's taken a while to address it, and I was otherwise occupied at the time, so I didn't notice it.

But anyway, if you want to have MSDN-style docs, take a look at Sandcastle. Here's the post on the August CTP.

Kudos to the Sandcastle folks.