From e5d73d8e0d977750e9b2a72571373df8e2bb7f0a Mon Sep 17 00:00:00 2001 From: Cheng Lou Date: Tue, 16 Jul 2013 21:39:20 -0400 Subject: [PATCH 1/3] Tweaked the intro page Here are some ideas that I think work better: - 15 repetitions of "React". Removed a few. - The "two main ideas" weren't clearly separated. I put them under different headers and simplified the wording. - The "Give it Five Minutes section didn't sound as reassuring. Made it sound more certain. --- docs/01-why-react.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/01-why-react.md b/docs/01-why-react.md index 0dbf7e806..fa3e31916 100644 --- a/docs/01-why-react.md +++ b/docs/01-why-react.md @@ -7,21 +7,23 @@ next: displaying-data.html --- React is a JavaScript library for creating user interfaces by Facebook and Instagram. Many people choose to think of React as the **V** in **[MVC](http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller)**. -We built React to solve one problem: **building large applications with data that changes over time**. To do this, React has two main ideas. +We built React to solve one problem: **building large applications with data that changes over time**. To do this, React uses two main ideas. -### Stay Simple and Declarative +### Simple -React apps are easy to write. Simply express how the UI should look at any given point in time, and React will manage all UI updates for you when your underlying data changes. +Simply express how your app should look at any given point in time, and React will automatically manage all UI updates when your underlying data changes. -It's just like writing a server-rendered web app: when the data changes, React conceptually hits the refresh button, except React is very fast and maintains the state of your UI. Because of this, React's API is very small and easy to understand. +### Declarative + +When the data changes, React conceptually hits the "refresh" button, and knows to only update the changed parts. ## Build Composable Components React is all about building reusable components. In fact, with React the *only* thing you do is build components. Since they're so encapsulated, components make code reuse, testing, and separation of concerns easy. -## Give it Five Minutes +## Give It a Try -React challenges a lot of conventional wisdom, and at first glance some of the ideas may seem crazy. We ask that you [give it five minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes) while reading about React; engineers and designers have built thousands of components both inside and outside of Facebook and Instagram, and we hope you'll find it useful! +We solved a lot of problems through challenging conventional wisdom. [Give it Five Minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes); engineers and designers have built thousands of components both inside and outside of Facebook and Instagram: those crazy ideas work. ## Learn More From 7406731c6cdc34f056fb4b5c12861cfa10a69042 Mon Sep 17 00:00:00 2001 From: Cheng Lou Date: Wed, 17 Jul 2013 00:12:21 -0400 Subject: [PATCH 2/3] changing back to 'give it five minutes', tweak that sentence --- docs/01-why-react.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/01-why-react.md b/docs/01-why-react.md index fa3e31916..2f7539808 100644 --- a/docs/01-why-react.md +++ b/docs/01-why-react.md @@ -21,9 +21,9 @@ When the data changes, React conceptually hits the "refresh" button, and knows t React is all about building reusable components. In fact, with React the *only* thing you do is build components. Since they're so encapsulated, components make code reuse, testing, and separation of concerns easy. -## Give It a Try +## Give It Five Minutes -We solved a lot of problems through challenging conventional wisdom. [Give it Five Minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes); engineers and designers have built thousands of components both inside and outside of Facebook and Instagram: those crazy ideas work. +React challenges a lot of conventional wisdom, and at first glance some of the ideas may seem crazy. [Give it five minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes) while reading about this guide; those crazy ideas have worked for building thousands of components both inside and outside of Facebook and Instagram. ## Learn More From 3bd37c78e1a790105f2f8121aae6204b2a958474 Mon Sep 17 00:00:00 2001 From: Cheng Lou Date: Wed, 17 Jul 2013 00:15:49 -0400 Subject: [PATCH 3/3] grammar error --- docs/01-why-react.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/01-why-react.md b/docs/01-why-react.md index 2f7539808..0968b7290 100644 --- a/docs/01-why-react.md +++ b/docs/01-why-react.md @@ -23,7 +23,7 @@ React is all about building reusable components. In fact, with React the *only* ## Give It Five Minutes -React challenges a lot of conventional wisdom, and at first glance some of the ideas may seem crazy. [Give it five minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes) while reading about this guide; those crazy ideas have worked for building thousands of components both inside and outside of Facebook and Instagram. +React challenges a lot of conventional wisdom, and at first glance some of the ideas may seem crazy. [Give it five minutes](http://37signals.com/svn/posts/3124-give-it-five-minutes) while reading this guide; those crazy ideas have worked for building thousands of components both inside and outside of Facebook and Instagram. ## Learn More