In Visual studio, three backlashes don't result in a comment occurring between my two summary backlashes

Question

I am new to visual studio and between the summary backlashes an auto-generated comment should have been "computes a modified age integer". I would like to know how to fix it so that I can always learn something about a method that I have written.

Thanks for the help in advance.

Answer 1

When you are above a type or member and enter three slashes the editor will auto generate a summary tag and, if a method and it has parameters, then a param tag for each parameter. It'll also generate a returns tag if there is a return value. However that is it.

// 3 slashes here auto generates 
//    /// <summary>
//    /// </summary
void Foo ()
{}

// 3 slashes here auto generates 
//    /// <summary>
//    /// <param name="id"></param>
//    /// </summary
void Foo ( int id )
{
}

Everything else, including the actual text inside the doctag elements, you have to provide yourself. The editor has no way of knowing how to describe your member and therefore cannot fill any of this out for you.

Answer 2

Thanks for answering. Ah okay, so for it to auto-generate an answer, I would have needed to have a value in the () parentheses field? Or should I have an auto-generated item in the method void ComputeAge()

thanks in advance

Answer 3

If you want the actual comment text auto-generated, you'll need an extension like GhostDoc. Even then it's based on the method name and signature so it's only going to be as good as what you define. It won't tell you anything instructive necessarily.