search

kasecato / vscode-docomment

Generate XML documentation comments for Visual Studio Code
https://marketplace.visualstudio.com/items?itemName=k--kato.docomment
MIT License
49 stars 15 forks source link

Please do not deprecate #121

Open lonix1 opened 3 years ago

lonix1 commented 3 years ago

The readme says that now that /// doccomment feature is available in vscode, that you will deprecate this plugin.

Please don't.

For the vscode feature to work, one needs to set "editor.formatOnType": true. That is disabled by default, many people don't like it.

This plugin however works even if that setting is disabled. So this plugin is better than the vscode feature.

Torguen commented 3 years ago

I activated that and I activate the line formatting when a line of code is finished, I don't want that. Although I also activate the XML documentation natively, I don't understand what line formatting has to do with the XML documentation. I just want to be able to create XML documentation, I don't need line formatting, so this plugin works for me.

lonix1 commented 3 years ago

On the omnisharp plugin's repo, one of the authors stated that this plugin is "very aggressive" because it reads every keystroke. (And the omnisharp plugin is "lighter" as it uses the language server APIs.)

But... even though this is more aggressive, I prefer it! It does exactly what we need! :heart:

thomas-darling commented 2 years ago

Yep, strongly agree.

As long as "editor.formatOnType": true is required for the native implementation to work, this plugin is very much needed.

HebaruSan commented 2 years ago

I'm using vscodium at the moment, and the Format On Type setting does not give me XML comments in a C# file. Maybe that is one of the Microsoft-isms in vscode that vscodium removed? Only this extension has worked.