diff --git a/src/wayland/output/mod.rs b/src/wayland/output/mod.rs
index efb2458..ee60dfd 100644
--- a/src/wayland/output/mod.rs
+++ b/src/wayland/output/mod.rs
@@ -10,9 +10,9 @@
 //! You need to instanciate an `Output` for each output global you want
 //! to advertize to clients.
 //!
-//! Just insert it in your event loop using the `Output::new(..)` method.
-//! It returns a state token that gives you access to the `Output` in order
-//! to change it if needed (if the current resolution mode changes for example),
+//! Just add it to your Display using the `Output::new(..)` method.
+//! You can use the returned `Output` to change the properties of your
+//! output (if the current resolution mode changes for example),
 //! it'll automatically forward any changes to the clients.
 //!
 //! ```
@@ -23,7 +23,7 @@
 //!
 //! # fn main() {
 //! # let (mut display, event_loop) = wayland_server::Display::new();
-//! // Insert the Output with given name and physical properties
+//! // Create the Output with given name and physical properties
 //! let (output, _output_global) = Output::new(
 //!     &mut display, // the display
 //!     event_loop.token(), // the LoopToken
diff --git a/src/wayland/shm/mod.rs b/src/wayland/shm/mod.rs
index c194f73..a148ca9 100644
--- a/src/wayland/shm/mod.rs
+++ b/src/wayland/shm/mod.rs
@@ -11,7 +11,7 @@
 //! [the similar helpers](https://cgit.freedesktop.org/wayland/wayland/tree/src/wayland-shm.c)
 //! of the wayland C libraries.
 //!
-//! To use it, first add a `ShmGlobal` to your event loop, specifying the formats
+//! To use it, first add a `ShmGlobal` to your display, specifying the formats
 //! you want to support (ARGB8888 and XRGB8888 are always considered as supported,
 //! as specified by the wayland protocol) and obtain its `ShmToken`.
 //!