Added note for Global Ajax Event Handlers

[AurelioDeRosa]

Fixes gh-479

[kswedberg]

Is it 1.9 or 1.8? Descriptions currently say 1.8.

[AurelioDeRosa]

In 1.8 you should, in 1.9 you must. Is that clear enough?

[kswedberg]

Ah, I see. I think what you have is fine then. We typically use "As of jQuery x.x" instead of "Starting with x.x." Would you mind changing that phrase?

[AurelioDeRosa]

Updated based on your suggestion :)

[kswedberg]

Thanks @AurelioDeRosa. Are you going to also remove the notes that currently appear in the <longdesc>? (for example, "As of jQuery 1.8, the .ajaxStop() method should only be attached to document.")

[AurelioDeRosa]

I think your comment is related to #798. Can you check that issue I raised?

[kswedberg]

Yeah, that's what I saw. What I'm suggesting is, if you're adding the "global" note to each method, you should also remove the "local" note.

[AurelioDeRosa]

In this case, should I highlight that from 1.8 is recommended, but from 1.9 is mandatory?

[kswedberg]

Never mind. I (finally) see what you're getting at. Maybe just change the global note from "must" to "must" (using <em></em>).

If you do that, then it LGTM, so feel free to merge it..

[AurelioDeRosa]

@kswedberg updated based on your comment :)

[kswedberg]

Excellent. Thanks, @AurelioDeRosa ! Wanna merge it in?

[AurelioDeRosa]

@kswedberg Done!

[kswedberg]

Thanks, @AurelioDeRosa !