Where can I find a good documentation example?

Question

I am looking for a good example of documentation of an API (coded in C#) where structures are well documented.

Should include:

• Delegates
• Events
• Enums
• class
• struct

Right now, I am searching through http://code.google.com, but so far I have not found anything self explanatory.

Answer 1

Well, if (comments) you are just after code samples - the public API for protobuf-net has a reasonable amount of documentation comments:

• enum
• interface
• class
• delegate (although with 3.5 you should use Func<...>/Action<...>
• attribute

It is unusual to write structs, and due to the nature of protobuf-net doesn't use many events - but you get the idea.

These are (of course) shipped in an xml file alongside the dll to provide intellisense. I could run sandcastle against it - I just haven't felt the need.