diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6b643f0a54..7e83b7d16b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+- Use an absolute link to the book so it works when landing from crates.io
+  documentation page
+
 ## [v0.4.0] - 2018-11-03
 
 ### Changed
diff --git a/src/lib.rs b/src/lib.rs
index cb3389b0a8..6aad041ea5 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -7,7 +7,7 @@
 //!
 //! The user level documentation can be found [here].
 //!
-//! [here]: ../../book/
+//! [here]: https://japaric.github.io/cortex-m-rtfm/book/
 //!
 //! Don't forget to check the documentation of the [`#[app]`] attribute, which is the main component
 //! of the framework.