Creating API Documentation

Some customers have asked my how we create our API docs internally and what tools they can use...  Some of you may have already heard about Sandcastle, but I thought I'd spread the word even more..

Sandcastle enables managed class library developers throughout the world to easily create accurate, informative documentation with a common look and feel. Internally we use Sandcastle to ship .NET Framework documentation and also documentation to https://silverlight.net/quickstarts/ and https://ajax.asp.net/docs/

Sandcastle Highlights:

· Produces quality, comprehensive, familiar MSDN-like documentation.

· Works with or without authored comments.

· Supports Generics and .NET Framework 1.x, 2.x and 3.x

· Sandcastle has 2 main components (MrefBuilder and Build Assembler)

· MrefBuilder generates reflection xml file for Build Assembler

· Build Assembler includes syntax generation, transformation..etc

· Sandcastle is used internally to build .Net Framework documentation

Sandcastle Architecture:

Please see the post at https://blogs.msdn.com/sandcastle/archive/2006/07/28/681209.aspx

Sandcastle wiki site

Molly recently setup a wiki site to share Information about Sandcastle to our customers: www.sandcastledocs.com. On this web site, you can find links to the following information:

Sandcastle Blogs:

https://blogs.msdn.com/sandcastle