From 51050fc45ce0e84e40ab801deefe35baf4ee3c2c Mon Sep 17 00:00:00 2001
From: Héctor Ramón Jiménez <hector0193@gmail.com>
Date: Wed, 28 Aug 2019 06:56:10 +0200
Subject: Improve `Overview` section in `README`

---
 README.md  |  9 +++++----
 src/lib.rs | 11 ++++++-----
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index de2fd010..7467f514 100644
--- a/README.md
+++ b/README.md
@@ -67,8 +67,8 @@ struct Counter {
 }
 ```
 
-Now that we have state... When will it change? When either button is pressed!
-These user interactions are our __messages__:
+Next, we need to define the possible user interactions of our counter:
+the button presses. These interactions are our __messages__:
 
 ```rust
 #[derive(Debug, Clone, Copy)]
@@ -78,7 +78,8 @@ pub enum Message {
 }
 ```
 
-Next, let's put it all together in our __view logic__:
+Now, let's show the actual counter by putting it all together in our
+__view logic__:
 
 ```rust
 use iced::{Button, Column, Text};
@@ -108,7 +109,7 @@ impl Counter {
 }
 ```
 
-Finally, we need to be able to react to the __messages__ and change our
+Finally, we need to be able to react to any produced __messages__ and change our
 __state__ accordingly in our __update logic__:
 
 ```rust
diff --git a/src/lib.rs b/src/lib.rs
index 9dab0470..0e4a4834 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -43,8 +43,8 @@
 //! }
 //! ```
 //!
-//! Now that we have state... When will it change? When either button is pressed!
-//! These user interactions are our __messages__:
+//! Next, we need to define the possible user interactions of our counter:
+//! the button presses. These interactions are our __messages__:
 //!
 //! ```
 //! #[derive(Debug, Clone, Copy)]
@@ -54,7 +54,8 @@
 //! }
 //! ```
 //!
-//! Next, let's put it all together in our __view logic__:
+//! Now, let's show the actual counter by putting it all together in our
+//! __view logic__:
 //!
 //! ```
 //! # use iced::button;
@@ -139,8 +140,8 @@
 //! }
 //! ```
 //!
-//! Finally, we need to be able to react to the __messages__ and change our
-//! __state__ accordingly in our __update logic__:
+//! Finally, we need to be able to react to any produced __messages__ and change
+//! our __state__ accordingly in our __update logic__:
 //!
 //! ```
 //! # use iced::button;
-- 
cgit