1 files changed, 6 insertions, 5 deletions
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;