Improve wp.media documentation

[ericlewis]

Catch all ticket for me improving documentation in wp.media. Brisk review and acceptance appreciated.

[ericlewis]

First pass: attachment:28459.2.diff​

• remove unused sidebar in media.controller.Library defaults. (I'd guess sidebar was previously a region, which was consumed by AttachmentsBrowser at some point)
• group Selection defaults, Initial region modes, and Attachments browser defaults together in each state's constructor defaults.

(Previously removed describe from a few constructors in attachment:28459.diff​ thinking it isn't used, but realized it is)

[wonderboymusic]

In 28675:

Media modal documentation:

Add some clarity to default values for controllers.

Props ericlewis.
See #28459.

[ericlewis]

In attachment:28459.3.diff​,

• Boil down wp.media() description. Don't say that it opens a frame when it doesn't.
• Fix up and add to media.controller.Region event documentation.
• Add some state constructor descriptions.
• Methods are mapped from a StateMachine to its states collection, not the other way around.
• More minutia in diff.

[ericlewis]

In attachment:28459.4.diff​:

• everything in attachment:28459.3.diff​:
• media.view.RouterItem.click documentation

[wonderboymusic]

In 28688:

Improve inline doc descriptions in media-views.js.

Props ericlewis.
See #28459.

[DrewAPicture]

\o/ Nice work guys :-)

[ericlewis]

This ain't over till it's over

[ericlewis]

In attachment:28459.5.diff​ add docs to media.view.MediaFrame.Select methods. Remove a couple @this context documentation bits which were incorrect.

[wonderboymusic]

In 28989:

Add more docs for media.view.MediaFrame.Select methods.

Props ericlewis.
See #28459.

[DrewAPicture]

Missing docs are a bug.

[DrewAPicture]

Some @since tags

[DrewAPicture]

I have a feeling this will be an ongoing effort.

[wonderboymusic]

In 29739:

Add some @since annotations to media-views.js.

Props DrewAPicture.
See #28459.

[ericlewis]

In attachment:28459.7.diff​, docs.

[ericlewis]

attachment:28459.8.diff​ supplants attachment:28459.7.diff​.

[ericlewis]

In attachment:28459.9.diff​, add document the selection attribute for media.controller.Library constructor.

This supplants attachment:28459.8.diff​.

[wonderboymusic]

In 30245:

Improve wp.media documentation.

Props ericlewis.
See #28459.

[ocean90]

Closing as fixed for 4.1.