Document (non-)interaction between native and synthetic events

[bvaughn]

This issue was originally reported by @srittau as facebook/react/issues/10284

Text of the original issue:

I have been trying to find out why my React event handlers were not able to prevent event handlers on document. After hours of searching and experimenting, I stumbled across issue #7094, which explains it.

Unfortunately, the documentation at https://facebook.github.io/react/docs/handling-events.html gives the impression that React events work exactly like native events, apart from wrapping them in synthetic events, and could therefore interact with them. Please document that this is not the case.

The same applies to the documentation at https://facebook.github.io/react/docs/events.html, especially the first paragraph of the overview. A short remark on this page would be helpful as well.

[Emuentes]

@bvaughn @srittau Do these updates sufficiently clarify that there is a difference between the synthetic events and the native browser events?