diff --git a/docs/refactor/01-motivation.md b/docs/refactor/01-motivation.md
index c80bca75..7cc413a9 100644
--- a/docs/refactor/01-motivation.md
+++ b/docs/refactor/01-motivation.md
@@ -8,7 +8,7 @@ We built React to solve one problem: **building large applications with data tha
 
 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.
 
-It's just like writing a server-rendered web app: when the data changes, it's like React just hits the refresh button, except React is  very fast and maintains the state of your UI.
+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.
 
 ## Build composable components
 
diff --git a/docs/refactor/02-displaying-data.md b/docs/refactor/02-displaying-data.md
index 7cbb3439..c036afe3 100644
--- a/docs/refactor/02-displaying-data.md
+++ b/docs/refactor/02-displaying-data.md
@@ -51,7 +51,7 @@ setInterval(function() {
 
 ## Reactive updates
 
-View the finished code in a web browser and type your name into the text field. Notice that React is only changing the time string in the UI -- any input you put in the text field remains, even though the code is written in a declarative way.
+View the finished code in a web browser and type your name into the text field. Notice that React is only changing the time string in the UI -- any input you put in the text field remains, even though you haven't written any code to manage this behavior. React figures it out for you and does the right thing.
 
 ## JSX syntax