Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs: better phrasing #4185

Merged
merged 1 commit into from
Feb 7, 2022
Merged

docs: better phrasing #4185

merged 1 commit into from
Feb 7, 2022

Conversation

stuymedova
Copy link
Contributor

No description provided.

@github-actions github-actions bot added the beta label Dec 17, 2021
@github-actions
Copy link

Size Changes

📦 Next.js Bundle Analysis

This analysis was generated by the next.js bundle analysis action 🤖

⚠️ Global Bundle Size Increased

Page Size (compressed)
global 91.32 KB (🟡 +156 B)
Details

The global bundle is the javascript bundle that loads alongside every page. It is in its own category because its impact is much higher - an increase to its size means that every page on your website loads slower, and a decrease means every page loads faster.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

If you want further insight into what is behind the changes, give @next/bundle-analyzer a try!

One Hundred Eighty-five Pages Changed Size

The following pages changed size from the code in this PR compared to its base branch:

Page Size (compressed) First Load
/ 203.62 KB (🟡 +484 B) 294.95 KB
/404 202.73 KB (🟡 +494 B) 294.05 KB
/blog 37.29 KB (🟢 -634 B) 128.61 KB
/blog/2013/06/02/jsfiddle-integration 213.74 KB (🟢 -101 B) 305.07 KB
/blog/2013/06/05/why-react 215.47 KB (🟢 -106 B) 306.79 KB
/blog/2013/06/12/community-roundup 215.17 KB (🟢 -103 B) 306.5 KB
/blog/2013/06/19/community-roundup-2 215.84 KB (🟢 -104 B) 307.17 KB
/blog/2013/06/21/react-v0-3-3 213.89 KB (🟢 -103 B) 305.21 KB
/blog/2013/06/27/community-roundup-3 216.21 KB (🟢 -105 B) 307.53 KB
/blog/2013/07/02/react-v0-4-autobind-by-default 214.51 KB (🟢 -100 B) 305.83 KB
/blog/2013/07/03/community-roundup-4 215.58 KB (🟢 -104 B) 306.9 KB
/blog/2013/07/11/react-v0-4-prop-validation-and-default-values 214.38 KB (🟢 -103 B) 305.7 KB
/blog/2013/07/17/react-v0-4-0 215.09 KB (🟢 -102 B) 306.41 KB
/blog/2013/07/23/community-roundup-5 215.97 KB (🟢 -102 B) 307.29 KB
/blog/2013/07/26/react-v0-4-1 213.85 KB (🟢 -101 B) 305.18 KB
/blog/2013/07/30/use-react-and-jsx-in-ruby-on-rails 214.46 KB (🟢 -101 B) 305.78 KB
/blog/2013/08/05/community-roundup-6 215.26 KB (🟢 -105 B) 306.59 KB
/blog/2013/08/19/use-react-and-jsx-in-python-applications 214.47 KB (🟢 -102 B) 305.79 KB
/blog/2013/08/26/community-roundup-7 215.43 KB (🟢 -103 B) 306.76 KB
/blog/2013/09/24/community-roundup-8 216.87 KB (🟢 -104 B) 308.19 KB
/blog/2013/10/03/community-roundup-9 215.8 KB (🟢 -107 B) 307.12 KB
/blog/2013/10/16/react-v0.5.0 215.48 KB (🟢 -105 B) 306.81 KB
/blog/2013/10/29/react-v0-5-1 213.84 KB (🟢 -104 B) 305.17 KB
/blog/2013/11/06/community-roundup-10 217.46 KB (🟢 -106 B) 308.79 KB
/blog/2013/11/18/community-roundup-11 216.54 KB (🟢 -103 B) 307.86 KB
/blog/2013/12/18/react-v0.5.2-v0.4.2 214.31 KB (🟢 -103 B) 305.64 KB
/blog/2013/12/19/react-v0.8.0 214.74 KB (🟢 -101 B) 306.06 KB
/blog/2013/12/23/community-roundup-12 216.19 KB (🟢 -103 B) 307.52 KB
/blog/2013/12/30/community-roundup-13 215.98 KB (🟢 -105 B) 307.3 KB
/blog/2014/01/02/react-chrome-developer-tools 214.23 KB (🟢 -102 B) 305.56 KB
/blog/2014/01/06/community-roundup-14 215.57 KB (🟢 -102 B) 306.9 KB
/blog/2014/02/05/community-roundup-15 216.79 KB (🟢 -101 B) 308.11 KB
/blog/2014/02/15/community-roundup-16 216.5 KB (🟢 -105 B) 307.83 KB
/blog/2014/02/16/react-v0.9-rc1 216.91 KB (🟢 -104 B) 308.23 KB
/blog/2014/02/20/react-v0.9 217.35 KB (🟢 -107 B) 308.68 KB
/blog/2014/02/24/community-roundup-17 216.21 KB (🟢 -106 B) 307.54 KB
/blog/2014/03/14/community-roundup-18 217.18 KB (🟢 -101 B) 308.5 KB
/blog/2014/03/19/react-v0.10-rc1 215.49 KB (🟢 -105 B) 306.81 KB
/blog/2014/03/21/react-v0.10 215.51 KB (🟢 -104 B) 306.84 KB
/blog/2014/03/28/the-road-to-1.0 215.62 KB (🟢 -105 B) 306.95 KB
/blog/2014/04/04/reactnet 214.27 KB (🟢 -104 B) 305.59 KB
/blog/2014/05/06/flux 214.39 KB (🟢 -100 B) 305.72 KB
/blog/2014/05/29/one-year-of-open-source-react 214.62 KB (🟢 -101 B) 305.94 KB
/blog/2014/06/27/community-roundup-19 216.16 KB (🟢 -108 B) 307.48 KB
/blog/2014/07/13/react-v0.11-rc1 216.54 KB (🟢 -103 B) 307.87 KB
/blog/2014/07/17/react-v0.11 217.8 KB (🟢 -106 B) 309.12 KB
/blog/2014/07/25/react-v0.11.1 214.75 KB (🟢 -103 B) 306.08 KB
/blog/2014/07/28/community-roundup-20 216.3 KB (🟢 -105 B) 307.63 KB
/blog/2014/07/30/flux-actions-and-the-dispatcher 215.94 KB (🟢 -102 B) 307.26 KB
/blog/2014/08/03/community-roundup-21 215.97 KB (🟢 -105 B) 307.3 KB
/blog/2014/09/03/introducing-the-jsx-specification 213.97 KB (🟢 -101 B) 305.3 KB
/blog/2014/09/12/community-round-up-22 216.45 KB (🟢 -101 B) 307.78 KB
/blog/2014/09/16/react-v0.11.2 214.75 KB (🟢 -102 B) 306.07 KB
/blog/2014/09/24/testing-flux-applications 217.92 KB (🟢 -105 B) 309.25 KB
/blog/2014/10/14/introducing-react-elements 216.88 KB (🟢 -105 B) 308.21 KB
/blog/2014/10/16/react-v0.12-rc1 216.85 KB (🟢 -106 B) 308.17 KB
/blog/2014/10/17/community-roundup-23 217.42 KB (🟢 -103 B) 308.74 KB
/blog/2014/10/27/react-js-conf 214.02 KB (🟢 -102 B) 305.34 KB
/blog/2014/10/28/react-v0.12 216.79 KB (🟢 -99 B) 308.11 KB
/blog/2014/11/24/react-js-conf-updates 214.41 KB (🟢 -101 B) 305.73 KB
/blog/2014/11/25/community-roundup-24 217.65 KB (🟢 -108 B) 308.97 KB
/blog/2014/12/18/react-v0.12.2 214.44 KB (🟢 -101 B) 305.76 KB
/blog/2014/12/19/react-js-conf-diversity-scholarship 214.83 KB (🟢 -102 B) 306.15 KB
/blog/2015/01/27/react-v0.13.0-beta-1 215.79 KB (🟢 -107 B) 307.12 KB
/blog/2015/02/18/react-conf-roundup-2015 217.78 KB (🟢 -103 B) 309.11 KB
/blog/2015/02/20/introducing-relay-and-graphql 216.93 KB (🟢 -102 B) 308.26 KB
/blog/2015/02/24/react-v0.13-rc1 215.84 KB (🟢 -105 B) 307.16 KB
/blog/2015/02/24/streamlining-react-elements 218.39 KB (🟢 -108 B) 309.71 KB
/blog/2015/03/03/react-v0.13-rc2 215.17 KB (🟢 -104 B) 306.5 KB
/blog/2015/03/04/community-roundup-25 216.13 KB (🟢 -106 B) 307.46 KB
/blog/2015/03/10/react-v0.13 216.45 KB (🟢 -104 B) 307.78 KB
/blog/2015/03/16/react-v0.13.1 214.27 KB (🟢 -101 B) 305.59 KB
/blog/2015/03/19/building-the-facebook-news-feed-with-relay 217.03 KB (🟢 -103 B) 308.35 KB
/blog/2015/03/26/introducing-react-native 214.17 KB (🟢 -103 B) 305.49 KB
/blog/2015/03/30/community-roundup-26 216.1 KB (🟢 -107 B) 307.42 KB
/blog/2015/04/17/react-native-v0.4 215.01 KB (🟢 -102 B) 306.34 KB
/blog/2015/04/18/react-v0.13.2 214.35 KB (🟢 -104 B) 305.67 KB
/blog/2015/05/01/graphql-introduction 218.84 KB (🟢 -104 B) 310.16 KB
/blog/2015/05/08/react-v0.13.3 214.24 KB (🟢 -100 B) 305.56 KB
/blog/2015/05/22/react-native-release-process 214.39 KB (🟢 -102 B) 305.71 KB
/blog/2015/06/12/deprecating-jstransform-and-react-tools 214.84 KB (🟢 -103 B) 306.17 KB
/blog/2015/07/03/react-v0.14-beta-1 216.35 KB (🟢 -104 B) 307.68 KB
/blog/2015/08/03/new-react-devtools-beta 214.95 KB (🟢 -105 B) 306.28 KB
/blog/2015/08/11/relay-technical-preview 215.02 KB (🟢 -101 B) 306.34 KB
/blog/2015/08/13/reacteurope-roundup 216.61 KB (🟢 -102 B) 307.93 KB
/blog/2015/09/02/new-react-developer-tools 214.37 KB (🟢 -102 B) 305.69 KB
/blog/2015/09/10/react-v0.14-rc1 220 KB (🟢 -156 B) 311.33 KB
/blog/2015/09/14/community-roundup-27 216.53 KB (🟢 -104 B) 307.85 KB
/blog/2015/10/01/react-render-and-top-level-api 215.5 KB (🟢 -103 B) 306.82 KB
/blog/2015/10/07/react-v0.14 220.49 KB (🟢 -162 B) 311.81 KB
/blog/2015/10/19/reactiflux-is-moving-to-discord 216.25 KB (🟢 -100 B) 307.57 KB
/blog/2015/10/28/react-v0.14.1 214.26 KB (🟢 -102 B) 305.58 KB
/blog/2015/11/02/react-v0.14.2 214.29 KB (🟢 -102 B) 305.62 KB
/blog/2015/11/18/react-v0.14.3 214.42 KB (🟢 -101 B) 305.74 KB
/blog/2015/12/04/react-js-conf-2016-diversity-scholarship 215.29 KB (🟢 -100 B) 306.61 KB
/blog/2015/12/16/ismounted-antipattern 214.89 KB (🟢 -101 B) 306.21 KB
/blog/2015/12/18/react-components-elements-and-instances 218.81 KB (🟢 -104 B) 310.13 KB
/blog/2015/12/29/react-v0.14.4 214.08 KB (🟢 -103 B) 305.41 KB
/blog/2016/01/08/A-implies-B-does-not-imply-B-implies-A 215.1 KB (🟢 -103 B) 306.42 KB
/blog/2016/01/12/discontinuing-ie8-support 213.91 KB (🟢 -102 B) 305.23 KB
/blog/2016/02/19/new-versioning-scheme 215.29 KB (🟢 -103 B) 306.61 KB
/blog/2016/03/07/react-v15-rc1 217.98 KB (🟢 -164 B) 309.31 KB
/blog/2016/03/16/react-v15-rc2 214.9 KB (🟢 -103 B) 306.23 KB
/blog/2016/03/29/react-v0.14.8 214.04 KB (🟢 -103 B) 305.36 KB
/blog/2016/04/07/react-v15 222.1 KB (🟢 -243 B) 313.43 KB
/blog/2016/04/08/react-v15.0.1 214.79 KB (🟢 -101 B) 306.12 KB
/blog/2016/07/11/introducing-reacts-error-code-system 214.51 KB (🟢 -102 B) 305.83 KB
/blog/2016/07/13/mixins-considered-harmful 222.66 KB (🟢 -107 B) 313.98 KB
/blog/2016/07/22/create-apps-with-no-configuration 217.99 KB (🟢 -109 B) 309.31 KB
/blog/2016/08/05/relay-state-of-the-state 218.03 KB (🟢 -105 B) 309.35 KB
/blog/2016/09/28/our-first-50000-stars 219.47 KB (🟢 -106 B) 310.8 KB
/blog/2016/11/16/react-v15.4.0 217.43 KB (🟢 -107 B) 308.75 KB
/blog/2017/04/07/react-v15.5.0 217.99 KB (🟢 -107 B) 309.31 KB
/blog/2017/05/18/whats-new-in-create-react-app 217.39 KB (🟢 -115 B) 308.71 KB
/blog/2017/06/13/react-v15.6.0 216.01 KB (🟢 -104 B) 307.33 KB
/blog/2017/07/26/error-handling-in-react-16 216.36 KB (🟢 -104 B) 307.68 KB
/blog/2017/09/08/dom-attributes-in-react-16 216.79 KB (🟢 -107 B) 308.11 KB
/blog/2017/09/25/react-v15.6.2 215.13 KB (🟢 -105 B) 306.45 KB
/blog/2017/09/26/react-v16.0 220.25 KB (🟢 -106 B) 311.58 KB
/blog/2017/11/28/react-v16.2.0-fragment-support 218.16 KB (🟢 -111 B) 309.49 KB
/blog/2017/12/07/introducing-the-react-rfc-process 214.71 KB (🟢 -102 B) 306.03 KB
/blog/2017/12/15/improving-the-repository-infrastructure 230.5 KB (🟢 -113 B) 321.82 KB
/blog/2018/03/01/sneak-peek-beyond-react-16 214.66 KB (🟢 -102 B) 305.99 KB
/blog/2018/03/27/update-on-async-rendering 219.91 KB (🟢 -105 B) 311.23 KB
/blog/2018/03/29/react-v-16-3 216.73 KB (🟢 -99 B) 308.05 KB
/blog/2018/05/23/react-v-16-4 216.87 KB (🟢 -103 B) 308.19 KB
/blog/2018/06/07/you-probably-dont-need-derived-state 220.53 KB (🟢 -106 B) 311.85 KB
/blog/2018/08/01/react-v-16-4-2 215.51 KB (🟢 -107 B) 306.84 KB
/blog/2018/09/10/introducing-the-react-profiler 217.12 KB (🟢 -112 B) 308.45 KB
/blog/2018/10/01/create-react-app-v2 217.6 KB (🟢 -102 B) 308.93 KB
/blog/2018/10/23/react-v-16-6 216.8 KB (🟢 -103 B) 308.12 KB
/blog/2018/11/13/react-conf-recap 214.51 KB (🟢 -103 B) 305.84 KB
/blog/2018/11/27/react-16-roadmap 220.71 KB (🟢 -108 B) 312.03 KB
/blog/2018/12/19/react-v-16-7 215.64 KB (🟢 -103 B) 306.96 KB
/blog/2019/02/06/react-v16.8.0 217.9 KB (🟢 -104 B) 309.23 KB
/blog/2019/02/23/is-react-translated-yet 217.47 KB (🟢 -105 B) 308.8 KB
/blog/2019/08/08/react-v16.9.0 220.4 KB (🟢 -108 B) 311.72 KB
/blog/2019/08/15/new-react-devtools 215.01 KB (🟢 -105 B) 306.33 KB
/blog/2019/10/22/react-release-channels 216.82 KB (🟢 -103 B) 308.14 KB
/blog/2019/11/06/building-great-user-experiences-with-concurrent-mode-and-suspense 221.52 KB (🟢 -99 B) 312.85 KB
/blog/2020/02/26/react-v16.13.0 217.75 KB (🟢 -106 B) 309.07 KB
/blog/2020/08/10/react-v17-rc 224.02 KB (🟢 -108 B) 315.35 KB
/blog/all 53.41 KB (🟢 -622 B) 144.73 KB
/community 203.31 KB (🟡 +484 B) 294.64 KB
/community/acknowledgements 204.51 KB (🟡 +488 B) 295.83 KB
/community/meet-the-team 205.03 KB (🟡 +483 B) 296.35 KB
/learn 212.02 KB (🟡 +495 B) 303.35 KB
/learn/add-react-to-a-website 208.14 KB (🟡 +490 B) 299.47 KB
/learn/adding-interactivity 209.94 KB (🟡 +492 B) 301.27 KB
/learn/choosing-the-state-structure 215.69 KB (🟡 +490 B) 307.01 KB
/learn/conditional-rendering 207.92 KB (🟡 +495 B) 299.24 KB
/learn/describing-the-ui 207.13 KB (🟡 +492 B) 298.45 KB
/learn/editor-setup 204.41 KB (🟡 +492 B) 295.73 KB
/learn/escape-hatches 202.64 KB (🟡 +490 B) 293.97 KB
/learn/extracting-state-logic-into-a-reducer 213.29 KB (🟡 +493 B) 304.61 KB
/learn/importing-and-exporting-components 206.32 KB (🟡 +491 B) 297.64 KB
/learn/installation 203.96 KB (🟡 +491 B) 295.29 KB
/learn/javascript-in-jsx-with-curly-braces 206.39 KB (🟡 +491 B) 297.71 KB
/learn/keeping-components-pure 210.53 KB (🟡 +492 B) 301.85 KB
/learn/managing-state 209.24 KB (🟡 +493 B) 300.57 KB
/learn/manipulating-the-dom-with-refs 211.16 KB (🟡 +491 B) 302.48 KB
/learn/passing-data-deeply-with-context 210.67 KB (🟡 +488 B) 301.99 KB
/learn/passing-props-to-a-component 210.09 KB (🟡 +492 B) 301.42 KB
/learn/preserving-and-resetting-state 212.91 KB (🟡 +491 B) 304.23 KB
/learn/queueing-a-series-of-state-updates 207.89 KB (🟡 +491 B) 299.21 KB
/learn/react-developer-tools 203.84 KB (🟡 +490 B) 295.17 KB
/learn/reacting-to-input-with-state 212.36 KB (🟡 +500 B) 303.69 KB
/learn/referencing-values-with-refs 209.4 KB (🟡 +488 B) 300.73 KB
/learn/render-and-commit 206.38 KB (🟡 +492 B) 297.7 KB
/learn/rendering-lists 210.44 KB (🟡 +490 B) 301.77 KB
/learn/responding-to-events 209.44 KB (🟡 +490 B) 300.76 KB
/learn/scaling-up-with-reducer-and-context 207.46 KB (🟡 +492 B) 298.79 KB
/learn/sharing-state-between-components 208.17 KB (🟡 +491 B) 299.5 KB
/learn/start-a-new-react-project 204.81 KB (🟡 +491 B) 296.14 KB
/learn/state-a-components-memory 213.61 KB (🟡 +490 B) 304.94 KB
/learn/state-as-a-snapshot 207.43 KB (🟡 +492 B) 298.76 KB
/learn/thinking-in-react 209.32 KB (🟡 +490 B) 300.64 KB
/learn/updating-arrays-in-state 211.51 KB (🟡 +487 B) 302.83 KB
/learn/updating-objects-in-state 211.22 KB (🟡 +491 B) 302.54 KB
/learn/writing-markup-with-jsx 206.32 KB (🟡 +492 B) 297.64 KB
/learn/your-first-component 207.22 KB (🟡 +494 B) 298.54 KB
/reference 203.27 KB (🟡 +478 B) 294.59 KB
/reference/reactdom 203.42 KB (🟡 +484 B) 294.74 KB
/reference/render 204.76 KB (🟡 +485 B) 296.08 KB
/reference/usestate 211.24 KB (🟡 +485 B) 302.57 KB
Details

Only the gzipped size is provided here based on an expert tip.

First Load is the size of the global bundle plus the bundle for the individual page. If a user were to show up to your website and land on a given page, the first load size represents the amount of javascript that user would need to download. If next/link is used, subsequent page loads would only need to download that page's bundle (the number in the "Size" column), since the global bundle has already been downloaded.

Any third party scripts you have added directly to your app using the <script> tag are not accounted for in this analysis

Next to the size is how much the size has increased or decreased compared with the base branch of this PR. If this percentage has increased by 10% or more, there will be a red status indicator applied, indicating that special attention should be given to this.

@gaearon gaearon merged commit c089fbc into reactjs:main Feb 7, 2022
@stuymedova stuymedova deleted the patch-13 branch September 11, 2022 11:28
@stuymedova stuymedova changed the title docs: phrasing a sentence docs: better phrasing Nov 6, 2022
BetterZxx pushed a commit to BetterZxx/react.dev that referenced this pull request Mar 21, 2023
@docschina-bot @shamwela
@gaearon @stuymedova @smikitky @aayush-k @KnowsCount
docs(en): merge reactjs.org/main into zh-hans.reactjs.org/main @ cfa3670
eccde34 
 (reactjs#721)

* Sandpack error icon overlapping issue fix (reactjs#4302)

* sandpack error icon overlapping issue fix

* modified errorline css

* Improve font display (reactjs#4308)

* Generate Ids when there are none in local development (reactjs#4304)

* Generate Ids when there are no headings

* Tweak code

Co-authored-by: Dan Abramov <dan.abramov@gmail.com>

* [Beta] useState Troubleshooting (reactjs#4309)

* [Beta] useState Troubleshooting

* Tweaks

* tweak

* docs: phrasing a sentence (reactjs#4185)

* docs: phrasing a sentence (reactjs#4182)

* docs: phrasing a sentence

* Update extracting-state-logic-into-a-reducer.md

Co-authored-by: dan <dan.abramov@gmail.com>

* docs: fix a grammatical error (reactjs#4183)

Co-authored-by: dan <dan.abramov@gmail.com>

* Change "return statement" to "return keyword" (reactjs#4137)

* small fixes to stopwatch codesandbox (reactjs#4110)

* small fixes to stopwatch codesandbox

noticed that the explanation for the first stopwatch codesandbox mentions "update the time every 10 milliseconds" so updated the codesandbox to reflect that

also there's a small nuanced bug in the second stopwatch codesandbox where each call to `handleStart()` sets a new interval without checking if there's already one ongoing. 

Ie: If the user accidentally double clicks the start button, they set two intervals for updating `now` every 10ms and then intervalRef only retains the second interval ID. Thus, it's impossible to actually stop the timer because `handleStop()` will only clear the latest set interval while the original one will keep executing.

* Update referencing-values-with-refs.md

* Update referencing-values-with-refs.md

* Update referencing-values-with-refs.md

Co-authored-by: dan <dan.abramov@gmail.com>

* Resolve conflicts

Co-authored-by: Amaresh  S M <amaresh.suriya@freshworks.com>
Co-authored-by: Sha Mwe La <62544170+shamwela@users.noreply.github.com>
Co-authored-by: Strek <harish.sethuraman@freshworks.com>
Co-authored-by: Dan Abramov <dan.abramov@gmail.com>
Co-authored-by: Sofya Tuymedova <stuymedova@gmail.com>
Co-authored-by: Soichiro Miki <smiki-tky@umin.ac.jp>
Co-authored-by: Aayush Kumar <aayush.kumarmail@gmail.com>
Co-authored-by: KnowsCount <knowscount@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@import-brain import-brain import-brain approved these changes

Assignees
No one assigned
Labels
beta CLA Signed
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

None yet
4 participants
@stuymedova @import-brain @gaearon @facebook-github-bot