Reword some comments

src/block_on.rs

@@ -2,8 +2,9 @@
 //!
 //! This is equivalent to [`futures::executor::block_on()`], but slightly more efficient.
 //!
-//! The following blog post explains it in detail:
-//! - https://stjepang.github.io/2020/01/25/build-your-own-block-on.html
+//! The implementation is explained in detail in [*Build your own block_on()*][blog-post].
+//!
+//! [blog-post]: https://stjepang.github.io/2020/01/25/build-your-own-block-on.html
 
 use std::cell::RefCell;
 use std::future::Future;

src/blocking.rs

@@ -165,7 +165,7 @@ impl BlockingExecutor {
 ///
 /// # Examples
 ///
-/// Read a file to string:
+/// Read a file into a string:
 ///
 /// ```no_run
 /// use smol::blocking;
@@ -289,7 +289,7 @@ pub fn iter<T: Send + 'static>(
 ///
 /// # Examples
 ///
-/// Create an async reader that reads a file:
+/// Read from a file:
 ///
 /// ```no_run
 /// use futures::prelude::*;
@@ -400,7 +400,7 @@ pub fn reader(reader: impl Read + Send + 'static) -> impl AsyncRead + Send + Unp
 ///
 /// # Examples
 ///
-/// Create an async writer that writes into a file:
+/// Write into a file:
 ///
 /// ```no_run
 /// use futures::prelude::*;