Browse by Tags
All Tags »
Architecture (RSS)
Sandcastle September 2007 release includes the VersionBuilder tool under \ProductionTools folder to provide support for documenting multiple versions of a project. The VersionBuilder tool generates a single reflection data file from multiple version-specific
Read More...
Sandcastle September 2007 release was shipped without the Framework reflection data. This allowed us to reduce the Sandcastle installer size to 1.5 MB. In our previous releases we shipped the reflection files under the \Data\Reflection folder. For the
Read More...
The primary goal of componentization is to reduce the size of a run-time image. In addition to helping meet space requirements, componentization has the following benefits: Performance - Reducing disk and memory use can significantly improve performance
Read More...
With Sandcastle June CTP we are releasing a new documentation design code named “ Hana ”. We expect the release to be available on June 18, 2007. This presentation layer will be released as a part of Sandcastle and will not be used for Orcas documentation
Read More...
When we released Sandcastle last July we released it with the “Prototype” document model design. The ‘Prototype” document model was designed with the following ideas: 1. Don’t segregate members by visibility 2. Don’t segregate – Filter 3. Don’t Separate
Read More...
In my previous blogs I have discussed the architecture of BuildAssembler , a configurable build component stack of Sandcastle . As each topic is build, it is represented as an in-memory XML document. The document is passed through a stack of build components,
Read More...
Microsoft Most Valuable Professionals (MVPs) are exceptional technical community leaders from around the world who are awarded for voluntarily sharing their high quality, real world expertise in offline and online technical communities. Microsoft MVPs
Read More...
David Smith made some great observations regarding Sandcastle perf. issues on large assemblies at http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=1125897&SiteID=1 . We have been testing our code on Phoenix ( http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=1125897&SiteID=1
Read More...
I was thrilled to see Mary Jo Foley , from ZDNet, blog about Sandcastle at her “ Microsoft Codenames ” page. I met Mary at TechEd 2006 in Boston when my team was presenting a chalk talk on MSDN Wiki . I remember asking her after our talk to blog on MSDN
Read More...
Sandcastle supports C# (and VB) xml tags for developer documentation comments. The list of c# tags are available at http://msdn2.microsoft.com/en-us/library/5ast78ax.aspx . We added the following new custom nDoc tags in November CTP ( http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en
Read More...
Syntax in Sandcastle documentation is generated by SyntaxBuilder. SyntaxBuilder uses the Common Compiler Infrastructure (CCI) library to reflect over a set of managed assemblies and produce syntax blocks that represent each API in various languages. SyntaxBuilder
Read More...
I my previous blog s I discussed MrefBuilder and Sandcastle.config in detail. Sandcastle process uses three executables: MRefBuilder: Reflects over managed assemblies to produce an XML-formatted reflection information file. BuildAssembler: Collates information
Read More...
I my previous blog I discussed Sandcastle.config in detail. Sandcastle process uses three executables: MRefBuilder: Reflects over managed assemblies to produce an XML-formatted reflection information file. BuildAssembler: Collates information from comment
Read More...
Overview Sandcastle builds documentation for any managed class libraries. Sandcastle requires the following inputs: A set of managed assemblies (.dlls or .exes) to document The set of assemblies on which the operation of those assemblies depend (aka dependencies)
Read More...
Thanks for all your comments and feedback about the July CTP. I was away last week at a management training and will get back to all your comments. I also received several emails about Sandcastle and have started getting back them. This forum post had
Read More...
