Added a standards divergence warning to binders

[phistuck]

Returning false in jQuery event handlers stops the propagation of the event, while returning false in native event listeners only prevents the default.
This adds a bold note to some bind methods (part I).

[phistuck]

I will add the note to the rest if this pull request is approved.

[kswedberg]

@phistuck : thanks for the pull request. I think this is a fine thing to add, but it would probably be better to put the note in notes.xsl and just include it in the entries. Look at /entries/after.xml for an example of where and how to include the note ( e.g. <note id="disconnected-manipulation" type="additional" data-title=".after()"/> ).

@scottgonzalez : I'm actually not sure which is the appropriate approach here: adding a when condition to notes.xsl or adding a file in the /includes/ directory. Thoughts?

[kswedberg]

Also, @phistuck, could you please sign the CLA at http://contribute.jquery.org/CLA/? Thanks!

[phistuck]

@kswedberg I have already.

[kswedberg]

Ah, I see now. thanks.

[scottgonzalez]

I'd use notes.xsl.

[kswedberg]

thanks for weighing in, @scottgonzalez.

@phistuck, if you wouldn't mind updating the pull request as suggested, that would be great.

[phistuck]

@kswedberg - sure, I hope to get to it this weekend.

[gnarf]

@phistuck - ping - still interested in this?

[phistuck]

Generally, yes, but I am not sure when I will get to it. Sorry.

[arthurvr]

@phistuck Bump about the CLA. You will also need to include your real name in your git config.

[scottgonzalez]

@arthurvr @phistuck has requested to remain anonymous. You should see the approval for that in the CLA sheet.

[dmethvin]

It really seems strange to repeat this on so many different pages (this isn't even the complete list) and will be hard to maintain. Also the results are different for onevent-style handlers as well, it's not mentioned here. There should be a much DRY-er way to do this, perhaps an event overview page with all the differences.

[arschmitz]

@scottgonzalez @arthurvr @phistuck The problem is the CLA is signed with a different email then these commits use.

[gnarf]

We can use notes.xsl @dmethvin - there is a DRYer way

[dmethvin]

I agree that notes.xsl avoids copy/pasta of the actual phrase, but it duplicates the information about events across a huge swath of pages which seems bad. There's quite a bit of general discussion regarding events in the entry for .on() that applies to all events and I wouldn't want to duplicate that across pages either.

[phistuck]

I will probably not get to it. Anyone of you is free to take this. Closing this.