Docs: Remove @summary tags from JSDoc.

As decided in the JavaScript core chat. With a few reasons:

* It is visually cleaner when reading the source.
* This bring the JavaScript documentation closer to the PHP documentation.

The only disadvantage is that the JSDoc parser doesn't split out the summary and the description in the new format. We've decided to solve this when building the JavaScript documentation parser.

Props herregroen.
Fixes #42901.


git-svn-id: https://develop.svn.wordpress.org/trunk@42411 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Anton Timmermans
2017-12-18 14:13:58 +00:00
parent 05d60c580e
commit bc35d72a63
24 changed files with 338 additions and 371 deletions
@@ -77,7 +77,8 @@
} )();
/**
* @summary Add or remove ARIA attributes.
* Add or remove ARIA attributes.
*
* Uses jQuery's width() function to determine the size of the window and add
* the default ARIA attributes for the menu toggle if it's visible.
* @since Twenty Fifteen 1.1
@@ -122,7 +122,8 @@
} );
/**
* @summary Add or remove ARIA attributes.
* Add or remove ARIA attributes.
*
* Uses jQuery's width() function to determine the size of the window and add
* the default ARIA attributes for the menu toggle if it's visible.
* @since Twenty Fourteen 1.4
@@ -75,9 +75,11 @@
} )();
/**
* @summary Add or remove ARIA attributes.
* Add or remove ARIA attributes.
*
* Uses jQuery's width() function to determine the size of the window and add
* the default ARIA attributes for the menu toggle if it's visible.
*
* @since Twenty Thirteen 1.5
*/
function onResizeARIA() {