• Welcome to Valhalla Legends Archive.
 

The new documentation compiler...

Started by MyndFyre, July 18, 2006, 01:24 PM

Previous topic - Next topic

MyndFyre

Sandcastle:

http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=517576&SiteID=1

Sandcastle is the product used internally by Microsoft to build the documentation for the .NET Framework.  This is very exciting to me as I'll no longer need to decide, for example, when to use b tags instead of see cref's when writing documentation (unless this is done by Microsoft as well, in which case they're INSANELY consistent).  But it's also exciting that we don't need to rely on a third-party tool to make something that almost mimics MSDN.  Don't get me wrong - NDoc was great - but some places just didn't quite fit the bill.

I'm hoping they'll let the community provide some measure of extensibility.  All told, Microsoft has been great at doing so with the .NET Framework.  I hope the program manager in charge isn't a dumbass.
QuoteEvery generation of humans believed it had all the answers it needed, except for a few mysteries they assumed would be solved at any moment. And they all believed their ancestors were simplistic and deluded. What are the odds that you are the first generation of humans who will understand reality?

After 3 years, it's on the horizon.  The new JinxBot, and BN#, the managed Battle.net Client library.

Quote from: chyea on January 16, 2009, 05:05 PM
You've just located global warming.


BaDDBLooD

There are only two kinds of people who are really fascinating: people who know absolutely everything, and people who know absolutely nothing.