Commit Graph

560 Commits

Author SHA1 Message Date
Dan
a00440d4e7 Properly cross-link tutorial and guide. Explain why. 2018-06-23 03:32:12 +01:00
Dan
db66436112 Make CodePen links more prominent and consistent 2018-06-23 02:10:56 +01:00
Adam Saghy
2ea33ffc3d Update conditional-rendering.md (#990)
`componentWillUpdate` method will be called before the render method so the returning value of the render method does not affect.
2018-06-22 23:38:31 +01:00
Stephen Lau
61a8b62b03 Mention getSnapshotBeforeUpdate should return. (#930)
If getSnapshotBeforeUpdate does not return a snapshot value or null
it will cause a warning.  Document that it should return this value.
2018-06-22 12:08:54 +01:00
Rodrigo Bermúdez Schettino
24f0448d7c Update Ref API in docs (#970)
* Update Ref API in docs

Update to new React.createRef() API in guide "Uncontrolled Components".

* Update Ref API in doc example

Use new Ref API in guide's example.

* Fix syntax error in example

* Update highlighting ranges in docs

After updating to the new createRef API, the highlighting ranges in Uncontrolled Components were wrong.

* Update highlighting ranges in docs example

After updating to the new createRef API, the highlighting ranges in Uncontrolled Components were wrong.

* Update highlighting ranges in docs example

Remove empty line in source code.

* Update uncontrolled-components.md

* Update input-type-file.js
2018-06-22 12:08:03 +01:00
Sophie Alpert
5045e82b2a Clarify class lifetime in class conversion example (#912)
* Clarify class lifetime in class conversion example

* Update state-and-lifecycle.md
2018-06-22 12:07:04 +01:00
Jonathan Berger
c47933a314 Correct typo in FAQ (#985)
Correcting a small typo.
2018-06-22 11:57:48 +01:00
Andy Edwards
af3b37ece3 docs(forwarding-refs.md): add warning to third-party library maintainers (#968)
* docs(forwarding-refs.md): add warning to third-party library maintainers

* Update forwarding-refs.md

* Update forwarding-refs.md

* Update forwarding-refs.md

* tweaks
2018-06-12 03:41:20 +01:00
Alex Krolick
ee650c8b30 Reorganize Hello World Page (#962)
* Reorganize Hello World Page

Move codeblock to the very top and and "following along" heading

* Match tense

* Remove subheading
2018-06-11 18:54:36 +01:00
Dan Abramov
81dc09ede1 Make the reference doc tighter
Now that there are some cross referenced links we can tighten it up.
2018-06-11 03:24:41 +01:00
Dan Abramov
17c50df9d9 Explicitly order Main Concepts (#957) 2018-06-11 02:50:28 +01:00
Dan Abramov
853f3d1945 Quick Start -> Main Concepts (#956) 2018-06-11 02:37:00 +01:00
Dan Abramov
d430480318 Reorder advanced guides by alphabet
I think this way it's clearer they're unordered, thus making it clearer Quick Start *is* ordered.
2018-06-11 02:22:51 +01:00
Dan Abramov
f5b284e101 Remove misleading paragraph
This was never true
2018-06-11 02:19:02 +01:00
Dan Abramov
c9e99c8ae6 Avoid unnecessary ternary 2018-06-11 02:05:28 +01:00
Dan Abramov
c70187cdbf Cross-link more articles 2018-06-11 02:01:34 +01:00
Dan Abramov
a788a28708 Avoid ambiguity between elements and components 2018-06-11 00:36:52 +01:00
Dan Abramov
3346d710b9 Clarify we are talking about sync calls 2018-06-10 23:03:13 +01:00
Dan Abramov
4550cb0e6a Massage the section more and add details 2018-06-10 22:53:22 +01:00
Jenny Wong
941c1a4efc NOtes and ideas for hello-world.md file.
- you can _just_ open it in 
- It _renders_ a heading saying “Hello, world!” on the page.  - you are using the same  word as the thing you are describing. 
- “A Note on JavaScript”  the title doe snot suggest that you need to read it because you are learning about react ,not JS.  Something like  “React & JavaScript” or something like “Knowledge Level Assumptions”
- “we recommend **refreshing** your JavaScript knowledge so you can follow along more easily.” — refreshing suggest that someone. Already knows JS, so if they don’t know JS they will feel dejected. Try “We highly recommend [going through a Javascript tutorial]() to check your knowledge level.”
- “We also use some of the ES6 syntax”  - **We**  that suggests its a  us vs  the user.  Instead go for “**The documentation** will use some [ES6 Syntax](LINK TO WHAT IS ES6)”
2018-06-10 22:53:22 +01:00
Dan Abramov
640ac1397b No "just" 2018-06-10 21:58:13 +01:00
Dan Abramov
f285d002c5 Reduce visual noise in the list
It's obvious enough that this is the same method. I don't think repeating its name in the list brings any value, and it puts too much visual emphasis on something we're trying to deemphasize.
2018-06-10 21:51:09 +01:00
Dan Abramov
4f01e35b9d Rewrite some component doc parts 2018-06-10 21:38:44 +01:00
Dan Abramov
6fe2302aed Don’t make experienced users feel bad 2018-06-10 19:30:53 +01:00
Dan Abramov
7603eb964b Mark common lifecycles as bold (#948) 2018-06-10 19:02:25 +01:00
Dan Abramov
79411aa85b Reorder and rewrite some parts of lifecycle reference (#947)
* Reorder and rewrite some parts of lifecycle reference

* Link to the lifecycle diagram

* More recommendations
2018-06-10 18:26:32 +01:00
Sébastien Boulet
95112711bb fix link to anchor #unsafe_componentwillupdate (#920) 2018-05-31 13:10:53 +01:00
Sophie Alpert
3e87993047 Move static type checking above PropTypes 2018-05-29 09:47:37 -07:00
Brian Vaughn
3e80980c18 Renamed params for gDSFP 2018-05-24 18:18:04 -07:00
Andrew Clark
dfaf1eecba Merge pull request #904 from acdlite/16.4-release-post
16.4 blog post
2018-05-23 17:58:16 -07:00
Andrew Clark
983476e3f3 Update getDerivedStateFromProps docs 2018-05-23 15:31:27 -07:00
Philipp Spiess
a1f41f65a2 Don’t recommend PEP because it lacks features 2018-05-23 14:28:42 -07:00
Philipp Spiess
988a67739d Add section about Pointer Events
This PR adds a section about the state of Pointer Events in React.

This should be merged only if facebook/react#12507 is accepted as well.
2018-05-23 14:28:30 -07:00
John Park
665ccbf907 Missing closing quotation in line 225 for <Button /> (#905) 2018-05-23 21:04:29 +01:00
pushpinder107
06f8553e90 Fixes typo (#902) 2018-05-23 12:48:45 +01:00
Brian Vaughn
822fc42852 Merge pull request #891 from cyan33/warn-legacy-context-in-strict-mode
add #Detecting legacy context apis for strict mode post
2018-05-22 15:42:33 -07:00
Dan Burzo
1d5217a293 Clarify change propagation in Context API (#896) 2018-05-21 14:01:22 +01:00
barnonahill
9b72ba6f05 Add a sentence to the end of componentWillUnmount() (#894)
Adds a sentence explaining not to use setState in componentWillUnmount, see https://github.com/facebook/react/issues/12111
2018-05-20 23:52:19 +01:00
cyan33
5ce098c1a1 refactor the wording 2018-05-18 14:56:07 -07:00
cyan33
1b5cf20dcc add #detecting legacy context apis for strict mode post 2018-05-17 14:40:47 -07:00
Tung Vu
1f8fdac9cc doc: add createRef to Refs glossary (#875)
* doc: add createRef to Refs glossary

* doc: move newer api first
2018-05-12 14:24:27 +01:00
Stephane Moreau
f03e9c785d "Introducing JSX" is missing a step (#812)
* Introducing JSX is missing a step

* Tweak
2018-05-09 18:19:39 +01:00
Alex Krolick
c95de8b59a Clarify defaultValue usage (#868)
Fixes #867
2018-05-07 23:48:13 -07:00
Duc Nghiem Xuan
d0cdc9ef0c Fix elmish-react link on static-type-checking (#857)
`fable-elmish` org is now simply `elmish`, thus the link to `elmish-react` was 404.

ref https://github.com/elmish/elmish/issues/145
2018-05-02 01:00:27 -07:00
Dan Abramov
e3cf355618 Tweak componentWillReceiveProps docs (#856)
* Tweak componentWillReceiveProps docs

* Update reference-react-component.md
2018-05-01 13:11:08 +01:00
Rauno Freiberg
3279bd768b Fix JSX link in design principles section (#855) 2018-04-30 14:51:22 -07:00
Chester Law
f97629e6f0 Fix grammar in List and Keys documentation (#854) 2018-04-30 13:43:24 -07:00
Augustus Yuan
f1bdc9674e Replace meeting notes section with RFCS section (#848) 2018-04-27 22:07:37 +01:00
Eugene Kopich
f40682a583 new "Flow" URL (2) (#839) 2018-04-25 11:39:58 +01:00
Eugene Kopich
b147d01e75 new "Flow" URL (#838) 2018-04-24 18:24:05 +01:00