Stumbled across ic#code’s free ebook ‘The fine art of commenting’ this morning, it’s from 2002 but everything still applies, you can download it here.
The book covers commenting in general and not just C#, but in relation to C# here’s the list of the predefined xml tags you can use in comments (something I have to search every time..):
| <c> | Marks a part of a comment to be formatted as code |
| <code> | As above, but multiline |
| <example> | For embedding examples in comments, usually uses <c> |
| <exception>* | Documents an Exception class |
| <include>* | Includes documentation from other files |
| <list> | A list of <term>s defined by <description>s |
| <para> | Structures text blocks, e.g. in a <remark> |
| <param>* | Describes a method parameter |
| <paramref>* | Indicates that a word is used as reference to a parameter |
| <permission>* | Gives the access permissions to a member |
| <remarks> | For overview of what a given class or other type does |
| <returns> | Description of the return value |
| <see>* | Refers to a member or field available |
| <seealso>* | As above, but displays a ‘See also’ section |
| <summary> | A summary of the object |
| <value> | Describes a property |
* validated by the C# compiler
