The current documentation states that the `<select>` tag supports `defaultChecked`, but it actually doesn't. I believe this documentation was meant to be written in the proposed order.
Non-working fiddle using `defaultChecked`: http://jsfiddle.net/jqs1hsLr/1/
Working fiddle using `defaultValue`: http://jsfiddle.net/nv7z0yzL/1/
Rendering to `document.body` in the examples is conveniently short, but it can
be misleading at the same time, especially for newcomers.
While it's possible to render React components to `document.body`, any 3rd
party scripts can also mess up with it, and it can have unintended consequences
and be source of difficult-to-trace bugs.
Now that #1169 is fixed, the only thing this is used for is to determine whether `onTouchTap` causes touch listeners to be added. The only internal uses of TapEventPlugin are where touch events are already initialized (so this doesn't make a difference) and we don't support `onTouchTap` as part of the public API so this should be safe.
I mis-parsed 'shallow copies' as adjective noun, instead of as a compound verb. I've adjusted the text to make it easier to parse on the first read, which should also help ESL learners to be able to parse it easier.
Summary:
This section was confusing. I reworded it from:
"JSX is completely optional. You don't have to use JSX with React.
You can create these trees through `React.createElement`. The first
argument is the tag, pass a properties object as the second
argument and children to the third argument."
to:
"JSX is completely optional; you don't have to use JSX with React.
You can create React elements in plain JavaScript using
`React.createElement`, which takes a tag name or component, a
properties object, and variable number of optional child
arguments."
and additionally added another child element to the example code.
Test Plan:
Read the new paragraph!
Ustin Zarubin
Alex Lopatin
Andreas Savvides
clariroid
Andreas
Damien Pellier
Bob Renwick
Cheng Lou
Paul O’Shannessy
Julen Ruiz Aizpuru
Ben Alpert
Julian Viereck
xmo-odoo
Stefan Dombrowski
Richard Littauer
Sebastian Markbage
Jim
BinaryMuse
Rick Beerendonk
Aria Buckles
brafdlog
Daniel Mané
Bob Ralian
Toru Kobayashi
Alan deLevie
Brian Kung
Michelle Todd
Christopher Chedeau
Dan Fox
Henry Zhu
Vincent Riemer
noyobo
YouBao Nong
Preston Parry
G. Kay Lee
Andrew Cobby