Thank you very much for this. VS is adding more and more features to support JavaScript, I am surprised they still dont generate documentation comment template for JavaScript. Now I dont have to copy paste my js function in C# to generate the stubs.
Is it possible to add comments in JavaScript code that is inside the <script type="text/javascript"> tag. Currently nothing happens. I have a dummy .js file and i copy the functions there in order to get the auto generation to work.
Currently, it is not possible. It is not because it would be difficult to do so, I just have not had the time to test it in an html/aspx/cshtml file, so I did not want to include it. I'll try looking into it this evening and see how it fares.
Yes, I am definitely replying to myself, this is as much for me to remember what needs to be fixed as to let everyone know about current issues.
-Extension Crashes when no parentheses are on the same line as a function declaration
-On Extension Crash, the file is rendered un-editable until closing and re-opening the file.
Generate vsdoc xml comment in javascript code inside .aspx page.
Is it possible to add comments in JavaScript code that is inside the <script type="text/javascript"> tag. Currently nothing happens. I have a dummy .js file and i copy the functions there in order to get the auto generation to work.
Now that I feel I have something stable for VS2010 SP1, that is something I would like to look into. I'll let you know more when I get a chance to look into the details of supporting VS11. Since I am new to VS extensions, I do not know if that is something that will be really quick to do, or if it will take some time.
Thanks Daniel, for suggesting I create the extension for Visual Studio 2011. I've created the extension page here: http://visualstudiogallery.msdn.microsoft.com/0cb7304b-ad78-4283-ba2b-42804657fcdd
You can also download it through the extension manager in VS11.
If you run into any issues with it, don't hesitate to mention it in the discussions on that extension page.
I have currently implemented a somewhat stable return tag generator, but my question is when should a return tag actually be added?
There are a few stances I can see on this:
Every JavaScript function returns something:
Should every function comment stub have a return tag, then, whether something is explicitly defined or not?
The current implementation is unreliable in more complex code:
Would it be better to leave a return tag off completely, and let the user decide, or is an educated guess good enough?
The return tag is unimportant to me:
The return type may not be all that critical in a lot of cases, and when it is, it isn't that big of a deal to type it in myself.
Which approach would you rather I take?
-Always create a return tag
-Guess when to add the return tag
-Never create a return tag
-Other
Thanks for your input/suggestions!
View Large
