diff --git a/README.md b/README.md
index 3a606d6..0aa2e22 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,10 @@
 # Immediate Stats
 
-Game stats that reset every frame. Inspired by immediate mode rendering.
-Includes a derive macro which propagates stat resets to any stat fields.
+Game stats that reset every frame, inspired by immediate mode rendering.
+
+This makes it easy to implement temporary buffs/debuffs, and effects that change over time.
+Using a derive macro, stat resets are propagated to any stat fields, 
+making it easy to compose stats into more complex or specific objects.
 
 ```rust
 #[derive(StatContainer)]
diff --git a/immediate_stats/src/lib.rs b/immediate_stats/src/lib.rs
index c0abdb7..0f432d8 100644
--- a/immediate_stats/src/lib.rs
+++ b/immediate_stats/src/lib.rs
@@ -1,5 +1,8 @@
-//! Game stats that reset every frame.
-//! Inspired by immediate mode rendering.
+//! Game stats that reset every frame, inspired by immediate mode rendering.
+//!
+//! This makes it easy to implement temporary buffs/debuffs, and effects that change over time.
+//! Using a derive macro, stat resets are propagated to any stat fields,
+//! making it easy to compose stats into more complex or specific objects.
 //!
 //! Includes a [derive macro](macro@StatContainer) which propagates stat resets to any stat fields.
 //!