diff --git a/README.md b/README.md
index 60657091..0a7a350d 100644
--- a/README.md
+++ b/README.md
@@ -7,11 +7,14 @@ https://github.com/async-rs/async-std)
 [![Documentation](https://docs.rs/async-std/badge.svg)](https://docs.rs/async-std)
 [![chat](https://img.shields.io/discord/598880689856970762.svg?logo=discord)](https://discord.gg/JvZeVNe)
 
-This crate provices an async version of [`std`]. It provides all the interfaces you are used to, but async and ready for Rusts `async/await`-syntax.
-
-For detailed information, take a look at the [documentation][docs] and the associated [book][book].
+This crate provides an async version of [`std`]. It provides all the interfaces you are used to, but async and ready for Rusts `async/await`-syntax.
 
 [`std`]: https://doc.rust-lang.org/std/index.html
+
+## Documentation
+
+`async-std` comes with [extensive API domentation][docs] and a [book][book].
+
 [docs]: https://docs.rs/async-std
 [book]: https://book.async.rs
 
diff --git a/src/lib.rs b/src/lib.rs
index 2cefbc9e..ad1b0e4f 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,8 +1,12 @@
 //! Async version of the Rust standard library.
 //!
 //! This crate is an async version of [`std`].
+//! Higher-level documentation in the form of the book
+//! ["Async programming in Rust with async-std"][book]
+//! is available.
 //!
 //! [`std`]: https://doc.rust-lang.org/std/index.html
+//! [here]: https://book.async.rs
 //!
 //! # Examples
 //!