Inline Docs: Document shortcode attribute arrays

[johnbillion]

The various shortcodes in core accept numerous attributes, but these aren't documented in the inline docs for the callback functions. Upcoming patch fixes that.

[johnbillion]

Patch.

[johnbillion]

For those interested, my colleague Scott has written ​a plugin which adds autosuggest functionality for shortcodes. We're hoping to add support for the shortcode attributes too by reading the docblock, hence this patch.

[SergeyBiryukov]

$output = '' and $html = '' should probably be moved above the docblocks.

[DrewAPicture]

Replying to SergeyBiryukov:

$output = '' and $html = '' should probably be moved above the docblocks.

Actually, a couple of weeks ago we opted to take the approach of leaving the original value in the hook call and referencing a nonexistent variable in the phpdoc. So rather than creating a one-time variable, we'd just continue to pass '' and reference $html in the doc block.

[DrewAPicture]

Second pass + standards tweaks

[DrewAPicture]

I'd like to get this in for 3.9 – I think it would certainly set a good example for documenting shortcodes going forward.25661.2.diff​ brings a few descriptions and tags up to standard, and tweaks a few other things.

[johnbillion]

In 26915:

Inline documentation for core shortcode attributes.

Props DrewAPicture, johnbillion.
Fixes #25661.