diff --git a/examples/show.rs b/examples/show.rs
index 71c3c4be..9fb8538e 100644
--- a/examples/show.rs
+++ b/examples/show.rs
@@ -8,9 +8,9 @@ fn main() {
         libnotify::Notification::new("Summary", Some("Optional Body"), None);
     // Show the notification
     n.show().unwrap();
-    // You can also use the .show() convenience method on the context
+    // Update the existent notification
     n.update("I am another notification", None, None).unwrap();
-    // Show the update notification
+    // Show the updated notification
     n.show().unwrap();
     // We are done, deinit
     libnotify::uninit();
diff --git a/src/lib.rs b/src/lib.rs
index 8e02e02d..5f9da4fb 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -12,9 +12,9 @@
 //!                                          None);
 //!     // Show the notification
 //!     n.show().unwrap();
-//!     // You can also use the .show() convenience method on the context
+//!     // Update the existent notification
 //!     n.update("I am another notification", None, None).unwrap();
-//!     // Show the update notification
+//!     // Show the updated notification
 //!     n.show().unwrap();
 //!     // We are done, deinit
 //!     libnotify::uninit();