VSDoc is an awesome way of commenting Javascript, and I particularly like the ability to make one Javascript file 'depend' on another. This paves the way for Javascript minifiers/combiners that take into account proper ordering of script includes.
The only thing that might bother some is that it's VS-Doc.
Are there any competing formats that are vendor-neutral?
And how widely is the VSDoc standard used by non-Microsoft IDEs such as Eclipse, etc?