All: Mark event aliases as deprecated

[mgol]

This feeds on the ideas from @dmethvin from gh-972 to reuse existing event pages as they sometimes contain valuable info specific to those events but to instead use the on & trigger signatures there, leaving the shorthand ones as deprecated.

One difficulty with this approach is we cannot have both on & trigger under a single signature, so I had to split them. In order to avoid rewriting the pages too much, I just left the trigger signature linking to the on one. If we see fit, we can always split the sections better later.

I'll post the screenshots of what this PR proposes below; for the current state, you can just check https://api.jquery.com/blur/.

Fixes gh-1205

TODO:

• Migrate other event shorthands
• Migrate AJAX event shorthands (there's just on there, no trigger)
• Drop the Additional Notes section (and the corresponding XSLT node, I think)
• Make sure https://api.jquery.com/category/deprecated/deprecated-3.3/ doesn't show something confusing wrt. event shorthands

[mgol]

Preview of this PR (v1)

[mgol]

BTW, that remark about blur not bubbling in IE is quite outdated - it does not bubble anywhere. 😉

[mgol]

I also need to remove the "Additional Notes" section.

[mgol]

New version pushed. Changes:

1. The "Additional Notes" section removed (for all shorthands).
2. The alias properly marked as deprecated now.
3. The deprecated API description updated and marked as yellow. It now also links to non-deprecated aliases.

The screenshot of the content below:

Preview of this PR (v2)

[timmywil]

Thanks, that looks better

[mgol]

Since there are some differences in how ajax events work (e.g. no manual trigger), I also migrated ajaxStart, here's the result:

Preview of `ajaxStart` in this PR

[mgol]

@timmywil in the end, I had to separate shorthand pages (I pushed blur & focus for now) as it seems categories are only picked up from the first entry on multi-entry pages so they wouldn't show up on https://api.jquery.com/category/deprecated/deprecated-3.3/.

The new pages for deprecated APIs are named blur-shorthand & focus-shorthand. That way, the main event-focused content keeps history.

I also added the version/1.0 category back to on( "blur", ... ) entries even though on only arrived in 1.7 so that the blur event page shows up on https://api.jquery.com/category/version/1.0/, the same for other events.

[mgol]

I migrated everything now, this is ready for final review.

[dmethvin]

Thanks! This seems like a good way to approach things.

[mgol]

Up to date screenshots:

The /blur/ page

The /blur-shorthand/ page

[mgol]

Also, an up to date example for ajaxStart as AJAX events are a bit different, not having the .trigger() part:

The /ajaxStart/ page

The /ajaxStart-shorthand/ page