You can do proper XML documentation by doing three consecutive slashes (C#) or apostrophes (VB) and when someone brings up a function it will have the documentation in intellisense. Example from my last library:
[highlight=vb.net]
''' <summary>
''' Find the string contained between two points.
''' </summary>
''' <param name="MainStr">The string to search in.</param>
''' <param name="pt1">The first point to look for in 'MainStr'</param>
''' <param name="pt2">The second point to look for in 'MainStr'</param>
''' <param name="UseLastIndex">Decides whether or not to search for the last index of 'pt2'.
''' Optional, default False.</param>
''' <param name="StartFrom">Where to start searching for 'pt1' in the string.
''' Optional, default 0</param>
''' <returns>A 'StringResult' class, Value contains the string, EndIndex returns the index of the 2nd Point. Value will be empty if either point is not found.</returns>
''' <remarks>Hot sex.</remarks>
[/highlight]