2 ms·
I agree. Doxygen adds zero value. If I need to know what methods a class has, I have Intellisense/Roslyn for that, without even leaving emacs or my ide. What n
by na85 8y ago
I agree. Doxygen adds zero value. If I need to know what methods a class has, I have Intellisense/Roslyn for that, without even leaving emacs or my ide.
What needs to be in comments (and frequently isn't IME) is intent.
- aurelwu 8y agowith Doxygen or other code generation tools you can add images which can help users understand your API more easily though. Not saying images are always helpful but there are definitely use cases. Natively adding images into comments would be a super useful feature for each IDE I think. edit: actually there seems to be an extension for Visual Studio for example: https://marketplace.visualstudio.com/items?itemName=MsBishop.ImageComments https://marketplace.visualstudio.com/items?itemName=MsBishop... I feel silly for never searching for that ... but then unlike with Doxygen everyone needs to have that extension