Where do you put the function documentation so that it shows up on intellisense?

Question

I'm writing a library and I want to put documentation in my functions so that it will show up in intellisense, kind of like how the intellisense for the built in functions shows descriptions for each of the parameters and for the function itself. How do you put the documentation in? Is it through comments in the function or is it in some separate file?

Answer 1

Use XML comments above the function signature.

    /// <summary>
    /// Summary
    /// </summary>
    /// <param name="param1">Some Parameter.</param>
    /// <returns>What this method returns.</returns>

The GhostDoc plugin can help generate these for you.

Answer 2

Yes, use the three-slash comments.

Answer 3

As well as the XML comments you need to enable building the documentation (in the project settings) and keep the generated XML file with the assembly.

Answer 4

"XML Documentation Comments (C# Programming Guide) In Visual C# you can create documentation for your code by including XML tags in special comment fields in the source code directly before the code block they refer to."

http://msdn.microsoft.com/en-us/library/b2s063f7.aspx

you can then use Sandcastle to generate chm files too if you want

http://www.hanselman.com/blog/SandcastleMicrosoftCTPOfAHelpCHMFileGeneratorOnTheTailsOfTheDeathOfNDoc.aspx