Creating proper MSDN style documentation for your C# projects using SandCastle
In this article, I will walk you through series of steps to create a proper MSDN style documentation for your C#.NET projects using Visual Studio and SandCastle tool.
In this way you will make sure you create a proper documentation for your .NET projects out of reflection information and XML documentation comments in your source code!
This is an easy three step process for you to quickly generate MSDN style CHM help file for your .NET projects. In this way, we will make sure to create proper documentation as well.
Step 1: Document your code properly
Make sure to put proper xml comments across all your .NET namespaces, classes, declarations, methods and so on.
To comment your code, just simply type three forward slashes "///", rest will be automatically populated by Visual studio itself. In this way, you just put across comments to all your modules.
Step 2: Enable XML documentation property in the Output section of your Project Build properties.
Step 3: Generate a proper documentation out of reflection information and XML documentation comments in your source code.
Sandcastle comes in handy in this step.
Let's see what you need to create these CHM files:
•Download and Install Sand Castle via the MSI - Refer link below
http://sandcastle.codeplex.com/releases/view/47665
•Download and Install the Sand Castle Help File Builder (SHFB) MSI by Eric Woodruff
http://shfb.codeplex.com/
• Run SHFB GUI
• Create new project and add documentation sources (csproj or dll)to SHFB project
• Add references (csproj or dll)if any
• Set the help file format and other SHFB options
• Click on Build project under Documentation tab and please wait for the process to complete!
Hope this helps!
Thank you,
Sheik
Mohmd.Sheik@gmail.com