A friend had told me about Sandcastle and I looked it up. Sandcastle is a project by Microsoft, that is intended to create MSDN-style documentation from .NET assemblies…

I had managed to achieve my goal quite easily using Sandcastle, and I thought about sharing my experience to serve other people as a guide. This is just a quick write-up of what I did – I did not read Sandcastle’s documentation and I believe that I don’t know how to operate it to its full potential.

1. The first step is to download and install Sandcastle.
2. Next, if you haven’t done it already, you have to tell Visual Studio to build XML documentation files. This parses all your comments ( in the C# format ///

etc…) and creates an XML file that we will feed into Sandcastle. To enable XML documentation, you have to go to Proect->(Project Name) Properties… and tick the relevant checkbox in the Build menu:builddoc


3. We will now launch the Sandcastle GUI application, located in C:\Program Files\Sandcastle\Examples\generic ( replace C:\Program Files with wherever you had installed Sandcastle).
4. Add your assemblies (exe/dll) and XML comments file to the relevant list boxes and choose the desired output format. Enter you project name under “Name”.
5. Hit “Build”. The build process can take a while, and it may seem like the program is frozen, but it’s not.
6. Your documentation files should now be ready in C:\Program Files\Sandcastle\Examples\Your Project Name
7. If you chose CHM as an output format, you will now have to compile the CHM file. To do this you need to download and install Microsoft HTML Help Workshop
8. After installing HTML Help Workshop, you will have to run hhc.exe (from the directory where you installed it). hhc takes an hhp (HTML Help Project) file as an argument. Sandcastle has created this hhp file for you, and it should be in your Sandcastle project directory. Just run “hhc yourproject.hhp” and this will produce a CHM file in the project’s directory.

That’s it. You should now have your compiled CHM help file with nice MSDN-style documentation.

As I mentioned earlier, I don’t really know Sandcastle and will be happy to get some tips in the comments section if you have any.

From here:
http://www.bonf.net/2009/03/04/create-c-documentation-using-sandcastle/

http://en.csharp-online.net/Attributes

Contents

* 1 Attribute usage and syntax
* 2 Positional parameters
* 3 Named parameters
* 4 Using multiple attributes
* 5 Target type
* 6 Predefined attributes
* 7 Custom attributes
o 7.1 Creating a Custom Attribute Class
o 7.2 Assigning the AttributeUsageAttribute to your class
o 7.3 Creating positional parameters
o 7.4 Creating named parameters
* 8 Reflecting on attributes
* 9 MSDN references
* 10 See also

C# : Enum and overriding ToString on it
http://blogs.msdn.com/abhinaba/archive/2005/10/20/483000.aspx

Interesting blog and Post about Practical Concurrency Patterns: Lock-Free Operations
http://blogs.microsoft.co.il/blogs/sasha/archive/2008/07/30/practical-concurrency-patterns-lock-free-operations.aspx

Windows 64 Registry bugs
http://blog.typemock.com/2008/07/registry-on-windows-64-bit-double-your.html

http://www.red-gate.com/Products/ants_profiler/index.htm
http://www.yourkit.com/
http://msmvps.com/blogs/theproblemsolver/archive/2006/09/25/Red-Gate-_2D00_-ANTS-Profiler.aspx

With YourKit solutions, both CPU and memory profiling have come to the highest professional level, where one can profile even huge applications with maximum productivity and zero overhead.