JSDoc @summary tag

[tinganho]

I propose to use the jsdoc @summary tag when showing the hover information.

/**
 * @summary 
 * Get Document body.
 *
 * @description
 * Get the document body of the view. Sometimes, it is useful to render an
 * alert view or notify the user of something that have happened. These views
 * are owned by the document body, so to reference the document body, you use
 * `this.document`. And it is only, `ContentBaseView` and it derivatives that
 * has a reference to the document body.
 *
 * @example
 * ```
 * render () {
 *     return (
 *         <div className='NameField'>{this.l('NAME_FIELD')}</div>
 *     );
 * }
 * ```
 */
function getDocument() {
    return '';
}

Right now, the summary of the hover info is empty. I guess it doesn't recognize it at the moment?

[mjbvz]

I believe this tag is now displayed in TS 2.7 with VS Code insiders 1.20: