Creating a comment doc block

[jrieken]

From @TheColorRed on January 21, 2016 2:21

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.

Copied from original issue: microsoft/vscode#2140

[jrieken]

From @Tyriar on January 21, 2016 5:25

I believe you could do this with an extension

[jrieken]

From @weinand on January 21, 2016 9:11

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

[jrieken]

From @TheColorRed on January 21, 2016 16:9

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

[jrieken]

From @alexandrudima on January 26, 2016 11:15

@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

[jrieken]

From @TheColorRed on January 26, 2016 15:32

@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).

[DustinCampbell]

This is a duplicate of #8.