Commit Graph

580 Commits

Author SHA1 Message Date
Eslam Gamal Khoga
cf4e7fcff4 Update accessibility.md
removed additional tag's close />
2018-07-02 11:01:51 +02:00
Dan Abramov
50d2a9bfc8 Emphasize a section 2018-06-29 18:13:36 +01:00
Dan Abramov
8695e5a128 Link to homepage more prominently from Getting Started 2018-06-29 17:16:27 +01:00
embs
49053f3705 Fix another typo typo (#1021)
Remove duplicated word.

Related to #1007
2018-06-28 18:30:04 +01:00
Dan Abramov
8f89578d2d Make recommendations clearer 2018-06-28 16:42:02 +01:00
Dan Abramov
fd2185b157 Add "Quickly Try JSX" 2018-06-28 15:28:32 +01:00
Dan
796257b34e Minor tweaks 2018-06-28 02:53:48 +01:00
Dan
eff5afaf3b Less feels 2018-06-28 02:37:56 +01:00
Dan
9ecd614eb1 Sell JSX step better 2018-06-28 02:07:32 +01:00
Jon Kiparsky
ca4bdedbd6 Remove brand name (#1008)
The brand name in the example adds nothing to comprehensibility.
2018-06-27 18:25:43 +01:00
Dan Abramov
b709eb13e8 Wording tweaks 2018-06-27 18:15:43 +01:00
Dan Abramov
2d7c8c41ec Tweak cross-linking 2018-06-27 16:22:37 +01:00
Kristofer Selbekk
5b2eb6e2af Fix a typo typo (#1007) 2018-06-27 13:29:49 +01:00
Alex Krolick
fc3a5d8dcb Link to Parcel in Starter Kits (#991)
<!--

Thank you for the PR! Contributors like you keep React awesome!

Please see the Contribution Guide for guidelines:

https://github.com/reactjs/reactjs.org/blob/master/CONTRIBUTING.md

If your PR references an existing issue, please add the issue number below

-->
2018-06-26 21:33:13 -07:00
Dan Abramov
23e2c59da0 Wording 2018-06-26 19:00:09 +01:00
Dan Abramov
da1b319a04 Typo 2018-06-26 11:38:32 +01:00
Monica Powell
11e1854838 Grammar Update (#998) 2018-06-25 22:39:21 -07:00
Sylvan Mably
eb9e3be4bc Fix typo (#997) 2018-06-25 18:57:12 -07:00
Dan Abramov
10bef30202 Minor tweaks 2018-06-26 02:06:38 +01:00
Dan Abramov
623523131e Rewrite Installation and related docs (#996)
* Rewrite "adding React to existing app"

Fixes #988

* Some copy

* typo

* Update babel instructions

* Update umd link

* Add prod minification section

* Show "button" example in several targets

* wip

* More

* More

* tweak

* yas

* Multi root tip

* moaar

* alot

* Tweak links

* Explain better

* better lead

* tweaks

* tweaks

* wording

* More reassuring tone

* Grammar

* wording

* feedback from readers

* Use id, not class

* More nits

* Re-add a useful section
2018-06-26 01:24:56 +01:00
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