From @slowmove on July 5, 2016 6:28

It would be very interesting to make the intellisense, completion and documentation popup (for a method for instace) better thru the ability of VSCode to better understand standard jsdoc like @description and such to give some text description to how to use a function, not only @param and parameter typing.

Copied from original issue: microsoft/vscode#8747