Creating a comment doc block

[TheColorRed]

Is there anything that will allow for shorthand creation of documentation?

So for example, in C# if I type:

/// and press Enter

It would create a doc comment block

/// <summary>
///     Summary of my item
/// </summary>

It would add things such as:

• Summary
• Parameters
• Return
• Etc.

[Tyriar]

I believe you could do this with an extension

[weinand]

@TheColorRed Please try snippets: https://code.visualstudio.com/docs/customization/userdefinedsnippets

[TheColorRed]

I did do snippets as a final, but you can't have a snippet of /// so I had to use text instead. However, it would be nice if either:

• The editor picked up that /// was a saved snippet
• That this doc feature was built into the editor

[alexdima]

@TheColorRed Would you expect that typing /// prepopulates the contents in the doc comment with the parameters and return type of the current method?

cc @jrieken : would be a nice rich language feature

[jrieken]

The omnisharp extension should handle that

[TheColorRed]

@alexandrudima Yeah, that is what I was thinking would happen. It would also be nice if it was supported in other languages as well (at least eventually).

[jrieken]

This issue was moved to dotnet/vscode-csharp#20