Improve `Overview` section in `README`

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;