Windows Live Alerts

Sandcastle

Documentation compilers for managed class libraries
Welcome to MSDN Blogs Sign in | Join | Help
A year after launching Developer Content Wiki - MSDN Wiki

Other than shipping Sandcastle and help content for VS products my team has been involved with the release of MSDN Wiki. Tomorrow (December 7, 2007) marks the 1 year anniversary of the launch of MSDNWiki. We have approximately 4000 worldwide developers worldwide sharing their knowledge in 9 different languages over the past year. We invite you to join them and contribute code and content in a wiki environment alongside the MSDN online documentation. Are you ready to contribute? Here are some high level statistics about this project:

Hot Blocks (Most active in the past week)

FindMimeFromData Function () -- See Also: (4 edits)

Visual Studio -- test (3 edits)

DataRow.SetModified Method (System.Data) -- test (3 edits)

Using C++ Interop (Implicit PInvoke) -- The new marshaling classes make marshaling between managed type and native types much easier. (3 edits)

Custom Action Type 1 (Windows) -- Constants are defined in msidefs.h from the Windows Platform SDK's Include directory (3 edits)

SPListItem.CopyTo Method (Microsoft.SharePoint) -- Other possible exceptions (3 edits)

How to: Create a Custom Extraction Rule -- If the Visual Studio UI does not recognize the existence of your Custom Extraction Rule (3 edits)

WorkflowRuntime.GetWorkflow Method (System.Workflow.Runtime) -- WorkflowInstance Not Found (3 edits)

Drag and Drop an Object on a Canvas -- broken link (2 edits)

LoadImage Function () -- Return type (2 edits)

Most Active Blocks (Overall)

UriComponents Enumeration (System) -- Example (33 edits)

Abstract types should not have constructors -- Example (25 edits)

Move pinvokes to native methods class -- How to Fix Violations (20 edits)

Use properties where appropriate -- Controlling property expansion in the debugger (19 edits)

RegistrationServices.TypeRepresentsComType Method (System.Runtime.InteropServices) -- Related APIs (19 edits)

Dynamic-Link Libraries (Windows) -- C:\WINDOWS\system32\SHELL32.dll (17 edits)

Override equals on overloading operator equals -- Example using a class (16 edits)

Assemblies should have valid strong names -- How to quickly sign your assembly. (15 edits)

Welcome to the Windows SharePoint Services 3.0 SDK -- Additional Resources (15 edits)

Visual Studio -- Visual Studio and the unified IDE (14 edits)

Hot Topics (Most active in the past week)

Creating an Application Page in Windows SharePoint Services 3.0 (3 blocks)

Search Provider Extensibility in Internet Explorer 7 (3 blocks)

Visual C# Documentation Roadmap (2 blocks)

Creating Search Queries Programmatically by Using the Search Web Service in SharePoint Server 2007 (2 blocks)

Progress Bar Controls (2 blocks)

How to: Create a Default Registry Value in Registry Editor (2 blocks)

SPWeb.GetSubwebsForCurrentUser Method (Microsoft.SharePoint) (2 blocks)

Visual Studio (2 blocks)

Removing Zombie Orchestration Instances (2 blocks)

Best Practices (2 blocks)

Most Active Topics (Overall)

Introducing Visual Studio (25 blocks)

Walkthrough: Creating a Basic SharePoint Web Part (17 blocks)

Walkthrough: Creating a Basic Web Part (12 blocks)

How to: Create a Minimal Master Page (10 blocks)

Dynamic-Link Libraries (Windows) (10 blocks)

How to: Create a Web Application in a SharePoint Web Site (10 blocks)

Microsoft Robotics Studio Community Wiki (10 blocks)

Template Parameters (9 blocks)

Use preferred terms (9 blocks)

Visual Studio (9 blocks)

Cummulative Totals
2/22/2006 to 12/6/2007

Topics with CC: 5062
Blocks: 6729
Edits: 10196
Contributors: 3735

Newest Contributors

scottsan (1)

ravievg (1)

pavouk100 (1)

SriVenkateshG (1)

lokoo (1)

cdiggity (1)

Dagonsoft (1)

Matt8175 (1)

wilsonjan (1)

ppadmana (1)

Most Active Contributors

David M. Kean - MSFT (696)

Thomas Lee (355)

Shawn Steele - MSFT (323)

Craig Skibo - MSFT (237)

MollyBos - MSFT (165)

Dzonny (144)

Noelle Mallory - MSFT (140)

Mahiways (131)

Dave Sexton (88)

Clayton Rogers - MSFT (80)

I will be interested in hearing your comments.

 

Anand..

Posted: Thursday, December 06, 2007 7:44 PM by aram
Filed under:

Comments

Nathanael Jones said:

Have you found a way to use Sandcastle with Web Site projects? Web Application projects won't work for me (I have 400+ .aspx files, and App_Code > 1MB) I only need need docs for App_Code, though.

Somebody else had the same question on the forums:

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

Thanks,

Nathanael Jones

# December 10, 2007 8:36 AM

aram said:

Nathanael,

I posted a response to http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=1126154&SiteID=1.

I checked with the ASp.NET compilation team. They tried a simple repro with some vb ''' doc comments and using the suggested codedom configuration. It seems that after compilation, the xml files are generated in the same location as the dlls in the “Temporary ASP.NET Files” folder.

Directory of C:\WINNT\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\doccomments\5e4632b0\3431084

12/12/2007  10:25 AM    <DIR>          .

12/12/2007  10:25 AM    <DIR>          ..

12/12/2007  10:24 AM             5,632 App_Code.c7q2t7hu.dll

12/12/2007  10:24 AM               232 App_Code.c7q2t7hu.xml

12/12/2007  10:24 AM               179 App_Code.compiled

12/12/2007  10:24 AM             8,192 App_Web_8akqmid7.dll

12/12/2007  10:24 AM               257 App_Web_8akqmid7.xml

12/12/2007  10:24 AM               384 default.aspx.cdcab7d2.compiled

12/12/2007  10:24 AM            16,203 default.aspx.cdcab7d2_CBMResult.ccu

12/12/2007  10:24 AM               387 default.aspx.cdcab7d2_CBMResult.compiled

Hope this helps. Cheers.

Anand..

# December 12, 2007 5:58 PM

Mahiways said:

Congrats for this Great Vision!!

~Mahesh Lambe

# December 25, 2007 7:03 AM
Anonymous comments are disabled

Page view tracker