Commit Graph
2337 Commits
Author SHA1 Message Date
Dan AbramovandFlarnie Marchan c51f8bc995 Bump docs version 2017-06-12 16:33:40 -07:00
Dan AbramovandFlarnie Marchan 3b7a6c8b56 Fix mobile layout 2017-06-12 16:33:40 -07:00
Dan AbramovandFlarnie Marchan aef13f093d Fix a typo 2017-06-12 16:33:40 -07:00
Dan AbramovandFlarnie Marchan 5458982197 Use a more specific link 2017-06-12 16:33:40 -07:00
Addy OsmaniandFlarnie Marchan 3300ecb48a Add DEV mode note to installation doc (#8784) (#9157)
* Add DEV mode note to installation doc (#8784)

* Address feedback from Dan on wording

(cherry picked from commit f86256ece0)
2017-06-12 16:33:40 -07:00
Dan AbramovandFlarnie Marchan bf4af51c99 Add more info about building for production (#9592)
* Add more info about building for production

* Add more info to the docs

(cherry picked from commit 185db64c76)
2017-06-12 16:33:40 -07:00
Joe CritchleyandFlarnie Marchan 4700f30d19 [Docs] Show the name 'React' first in the homepage's <title> (#9582)
(cherry picked from commit 109d1c95e3)
2017-06-12 16:33:40 -07:00
Frankie BagnardiandFlarnie Marchan e9c77935b4 [Tutorial] Make it easier to follow the instructions (#9454)
* tutorial: adds note about onClick

* tutorial: show full square component

* merge

* fixes line number

* tutorial: misc changes

* fixes Board render initial code sample

* [tutorial] adds codepen links and misc small fixes

* removes useless arrow functions, #9531

* {this.renderSquare} new lines

* be more explicit about history state

* fixes highlight

* following along locally

* changes todo to this.props.value

* removes calculateWinner from initial codepens and includes it in tutorial

* removes note about calculateWinner at end of file

* adds debug-view and debug-view-final

* removes debug view, updates codepen instructions

* adds another codepen

* tutorial.md

* tutorial.md

* tutorial.md

* tutorial.md

* Put . into links for consistency with docs

* Make the very first change easier to follow

* A few more changes

(cherry picked from commit e9d6f3f10e)
2017-06-12 16:33:40 -07:00
Marcos OjedaandFlarnie Marchan 2413107b1d docs better indicate that state updaters shallowly merge with state (#9554)
this was a surprise to me because the docs seemed to indicate that when
using an updater, the result _needed_ to be a new state object. I was
[not alone](https://twitter.com/ken_wheeler/status/857939690191806464)
i think in discovering this as a result of the previous tweet in the
thread.
(cherry picked from commit f737d63302)
2017-06-12 16:33:40 -07:00
Sriram ThiagarajanandFlarnie Marchan f66c60c636 pre format only compile time errors (#9538)
* pre format only compile time errors

* Style tweak

(cherry picked from commit 70c01963d9)
2017-06-12 16:33:40 -07:00
Paul O’ShannessyandFlarnie Marchan 11ef9da924 Don't build gh-pages branch on CircleCI (#9442) 2017-06-12 16:33:40 -07:00
waciiandFlarnie Marchan edd83dd8fc Add guide on integrating with non-react code (#9316)
* Add guide on integrating with non-react code

* Capitalize guide title

* Make links to other docs relative

* Rephrase 'What it does do'

* Remove experimental syntax

* Capitalize Backbone

* Remove empty lifecycle method in generic jQuery example

* Use shouldComponentUpdate() not componentWillUpdate()

* Prefer single quotes

* Add cleanup to generic jQuery example

* Capitalize React

* Generalize the section on Backbone Views

* Generalize the section on Backbone Models, a little

* Add introduction

* Adjust wording

* Simplify ref callbacks

* Fix typo in generic jQuery example

* Fix typos in Backbone models in React components

* Fix more typos in Backbone models in React components

* Add generic section on integrating with other view libraries

* Stress the benefits of an unchanging React element

* Small changes to introduction

* Add missing semicolon

* Revise generic jQuery wrapper section

Moved the section on using empty elements to prevent conflicts above the
code example and added brief introduction to that example.

* Add usage example for Chosen wrapper

* Prevent Chosen wrapper from updating

* Note that sharing the DOM with plugins is not recommended

* Mention how React is used at Facebook

* Mention React event system in template rendering section

* Remove destructuring from function parameters

* Do not name React components Component

* Elaborate on unmountComponentAtNode()

* Mention preference for unidirectional data flow

* Rename backboneModelAdapter

* Replace rest syntax

* Respond to updated model in connectToBackboneModel

* Rewrite connectToBackboneModel example

* Rework connectToBackboneModel example

* Misc changes

* Misc changes

* Change wording

* Tweak some parts

(cherry picked from commit 1816d06d6b)
2017-06-12 16:33:40 -07:00
RSGandFlarnie Marchan 292565fbc3 React.createElement syntax (#9459)
* React.createElement syntax

Added React.createElement syntax.
I think this is required for this tutorial.

* Reword

(cherry picked from commit 9824d52a4c)
2017-06-12 16:33:40 -07:00
Sriram ThiagarajanandFlarnie Marchan 34ab372824 fixed error formatting in live editor (#9497)
(cherry picked from commit 7ccfb07337)
2017-06-12 16:33:39 -07:00
Daniel Lo NigroandFlarnie Marchan cf41c522a9 [site] Load libraries from unpkg (#9499)
* [site] Load libraries from unpkg

* Revert Gemfile changes

(cherry picked from commit cf24d87177)
2017-06-12 16:33:39 -07:00
chocolateboyandFlarnie Marchan fc33c50020 [Docs] Fix confusing description for the <script>...</script> usage (#9502)
* Fix confusing description for the <script>...</script> usage

* Update jsx-in-depth.md

* Update reference-react-dom-server.md

* Update reference-react-dom.md

* Update reference-react.md

(cherry picked from commit 3d60d4cc7d)
2017-06-12 16:33:39 -07:00
Dmitri ZaitsevandFlarnie Marchan 4ad20dbf00 Add reference to the Hyperscript libraries (#9517)
* Add reference to the Hyperscript libraries

I feel these should be mentioned as they provide terser syntax than using `R.createElement` directly, even with a shorthand.

* Rephrase

(cherry picked from commit a8c223ab41)
2017-06-12 16:33:39 -07:00
Frankie BagnardiandFlarnie Marchan e85ec2f735 adds indirect refs to docs (#9528)
* adds indirect refs to docs

* Add more info

* Explain clearer

* Rephrase

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

* Update refs-and-the-dom.md

(cherry picked from commit 14fa8a5452)
2017-06-12 16:33:39 -07:00
Maciej KasprzykandFlarnie Marchan 5b77e75b6a Describe fixtures dir in the codebase overview (#9516)
* Describe fixtures dir in overview

* Fix folder name

(cherry picked from commit d12c41c7a6)
2017-06-12 16:33:39 -07:00
Jen WongandFlarnie Marchan efd2808071 Updates how-to-contribute.md to use JSFiddle referenced in submit Git issue template (#9503)
(cherry picked from commit c8a64e2637)
2017-06-12 16:33:39 -07:00
Flarnie MarchanandFlarnie Marchan 4a91038cef Add link to 'Typechecking with PropTypes' under 'Advanced Guides' (#9472)
This should have been retained in our docs, since PropTypes are only
moved and not deprecated.

Partially handles #9467, and I'll make a separate PR to
https://github.com/reactjs/prop-types to add more docs to the README
there.
(cherry picked from commit 39ca8aacf8)
2017-06-12 16:33:39 -07:00
David HuandFlarnie Marchan 7723dc4a39 Add more details in jsx-in-depth.md (#9006)
* jsx-in-depth.md add ternary statement for javascript expressions section

* jsx-in-depth.md add explanation to get falsey values for props

* update jsx-in-depth.md

* ensure links work locally, remove section about falsey prop values

* Fix links
2017-06-12 16:33:39 -07:00
Almero SteynandFlarnie Marchan 11d2471640 [Docs: Installation] Fix tabs responsive layout - Resubmit (#9458)
* [Docs: Installation] Fix tabs responsive layout

* Move tabs a pixel down

* Remove left margin on first tab

* Remove the long line

* Fix mobile styles

(cherry picked from commit a92128e7fb)
2017-06-12 16:33:39 -07:00
Almero SteynandFlarnie Marchan a7524ab0dd [Docs] Add accessibility to tabs in installation documentation (#9431)
* Add accessibility to tabs in installation documentation

* Change color and fix styling

(cherry picked from commit 9526174e30)
2017-06-12 16:33:39 -07:00
Fabrizio CastellarinandFlarnie Marchan dd8ac14522 Reorganize the "following along" instructions (#9453)
* Reorganize the "following along" instructions

* Minor tweaks

(cherry picked from commit 1ce562ead3)
2017-06-12 16:33:39 -07:00
Filip HoškoandFlarnie Marchan 4b577eb731 FIX: Move CRA build info under it's tab page (#9452)
* FIX: Move CRA build info under it's tab page

* Add some links
2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan 3f8c23e628 Tweak tutorial structure 2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan ac59a271cb Add missing tutorial sidebar links 2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan 1e68095b91 Minor tutorial nits 2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan 17d5b63e36 Fix duplicate sentence 2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan 0103dd1d38 Minor tweaks to tutorial 2017-06-12 16:33:39 -07:00
Frankie BagnardiandFlarnie Marchan 28c914decf [Tutorial] ES6, installation, and button closing tag (#9441)
* adds notes to tutorial on es6 and installation

* fixes tutorial mention of opening button tag

* More writing

* Update
2017-06-12 16:33:39 -07:00
Abhishek SoniandFlarnie Marchan 1ad0a3309f Fixed grammar (#9432)
* Update codebase-overview.md

* Some more fixes

(cherry picked from commit d724115144)
2017-06-12 16:33:39 -07:00
hanumanthanandFlarnie Marchan a5d07f0cac Lift state up - Updating the documentation to mention that onClick is a synthetic event handler (#9427)
* Lift state up - Updating the documentation to mention that onClick is a synthetic event handler

* Review comments - Rephrase to handle synthetic events and event handler patterns

* Tweak

(cherry picked from commit 53a3939fb0)
2017-06-12 16:33:39 -07:00
Michał OrdonandFlarnie Marchan 8706e4390f Sort out conferences by date (#9172)
(cherry picked from commit 37f9e35ad9)
2017-06-12 16:33:39 -07:00
Jayen AsharandFlarnie Marchan 8b71e9fced Update jsx-in-depth.md (#9178)
* Update jsx-in-depth.md

Line 9 isn't changed

* Move selection down

* Fix

(cherry picked from commit ccb38a96cf)
2017-06-12 16:33:39 -07:00
Fraser HaerandFlarnie Marchan a6102842ac Unique headings for linking purposes (#9259)
Previously two headings were 'Javascript Expressions' - now 'Javascript
Expressions as Props' and 'Javascript Expressions as Children'
(cherry picked from commit 363f6cb2e5)
2017-06-12 16:33:39 -07:00
NE-SmallTownandFlarnie Marchan 97542e7a99 [Documentation] Impreove the react-component section of doc (#9349)
* Impreove react-component of doc

[#9304](https://github.com/facebook/react/issues/9304)

* update description

* add missing space

(cherry picked from commit 359f5d276f)
2017-06-12 16:33:39 -07:00
Abhay NikamandFlarnie Marchan 7b7a3e9860 Updated the Good First Bug section in readme (#9429)
* Updated the Good First Bug section in readme

* Inconsistent use of quotes. Prefered single quotes instead of double quotes

* Updated Good first bug link in how_to_contribute doc.

* Undo JSX attribute quote change

* don't capitalize "beginner friendly issue"

(cherry picked from commit 36c935ca8f)
2017-06-12 16:33:39 -07:00
Dan AbramovandFlarnie Marchan 7bdf33b2c5 Switch Installation to a tab when hash is present (#9422) 2017-06-12 16:33:38 -07:00
hanumanthanandFlarnie Marchan dda27a3515 Refractor docs to indicate that state set to props in constructor will not recieve the updated props (#9404) 2017-06-12 16:33:38 -07:00
Marks PolakovsandFlarnie Marchan bed4e33259 Add tabs to installation page (#9275, #9277) (#9401)
* Add tabs to installation page (#9275, #9277)

This adds tabs for create-react-app and existing apps to the installation section of the docs. The tab implementation is a simplified version of React Native's installation page.

Fixes #9275.

* Use classList instead of className

* Use same implementation as in RN
2017-06-12 16:33:38 -07:00
JackandFlarnie Marchan f56ba1467f Update proptypes doc (#9391)
* Update proptypes doc

* Removed note
2017-06-12 16:33:38 -07:00
Eric ElliottandFlarnie Marchan 6a095209fe Docs: Clarification of setState() behavior (#9329)
* Clarification of setState() behavior

`setState()` is a frequent source of confusion for people new to React, and I believe part of that is due to minimization of the impact of the asynchronous behavior of `setState()` in the documentation. This revision is an attempt to clarify that behavior. For motivation and justification, see [setState Gate](https://medium.com/javascript-scene/setstate-gate-abc10a9b2d82).

* Update reference-react-component.md

* Signature fix

* Update to address @acdlite concerns

* Add more details
2017-06-12 16:33:38 -07:00
Gabriel Lett VivianiandFlarnie Marchan 4fd77b14b9 Fix the proptypes deprecation warning url on the "Don't Call PropTypes Warning" doc page (#9419)
* Use the same prop-types link on the warning docs page as the main proptypes doc page

* Link to repo instead
2017-06-12 16:33:38 -07:00
Nathan HunzakerandFlarnie Marchan 0001036d35 Move ReactDOMFactories into separate package (#8356)
- Update examples to no longer use React.DOM
- Add package and documentation entries for react-addons-dom-factories
- Update dom-factories readme
- Set up proxy to intercept React.DOM usage
- Update ReactDOM children tests to use createElement
- Add more specific warning assertion for React DOM factories
- Do not use expectDev in ReactDOMFactories tests
2017-05-09 13:51:22 +01:00
Dominic GannawayandDan Abramov e78b192e14 Update typechecking-with-proptypes.md (#9392)
* Update typechecking-with-proptypes.md

* Update typechecking-with-proptypes.md

* Use consistent style for PropTypes import
2017-04-12 00:05:11 +01:00
Denis PismennyandDan Abramov fd6eece6af Fix minor typo in lifting-state-up.md (#9408) 2017-04-11 22:06:30 +01:00
Maciej KasprzykandDan Abramov 9e9e0c700c Delete examples dir from codebase overview (#9397)
Removes doc about folder that no longer exists.
2017-04-11 22:05:47 +01:00
Luke BelliveauandDan Abramov 8f951556e1 Amended implementation-notes.md with link to Dan Abramov's post describing difference between React components, elements, and instances (#9388)
* Amended implementation-notes.md to include a link to a blog post by Dan Abramov, explaining the difference between components, elements, and instances. An understanding of this distinction is crucial in tracing through Implementation pseudocode, and reading Dan's blog first may ease newcomers into understanding the implementation.

* adjusted wording to maintain stylistic consistency with rest of content, per @aweary's request
2017-04-11 22:05:23 +01:00