diff --git a/awc/src/lib.rs b/awc/src/lib.rs
index 1607d5a4b..a98d6767d 100644
--- a/awc/src/lib.rs
+++ b/awc/src/lib.rs
@@ -193,8 +193,8 @@ impl Client {
         self.request(Method::OPTIONS, url)
     }
 
-    /// Initialize a WebSockets connection.
-    /// This method returns a builder structure to establish a WebSocket connection.
+    /// Initialize a WebSocket connection.
+    /// Returns a WebSocket connection builder.
     pub fn ws<U>(&self, url: U) -> ws::WebsocketsRequest
     where
         Uri: TryFrom<U>,
diff --git a/awc/src/ws.rs b/awc/src/ws.rs
index 1f53df63a..96687ac74 100644
--- a/awc/src/ws.rs
+++ b/awc/src/ws.rs
@@ -1,7 +1,6 @@
 //! Websockets client
 //!
-//! This module contains type definitions required to use [`awc::Client`](../struct.Client.html) as a WebSocket client.
-//! To use `awc::Client`
+//! Type definitions required to use [`awc::Client`](../struct.Client.html) as a WebSocket client.
 //!
 //! # Example
 //!
@@ -26,7 +25,6 @@
 //!     assert_eq!(response, ws::Frame::Text("Echo".as_bytes().into()));
 //! }
 //! ```
-//!
 
 use std::convert::TryFrom;
 use std::net::SocketAddr;