diff --git a/src/doc/src/reference/manifest.md b/src/doc/src/reference/manifest.md
index 9385a12026d..0fcf02b4276 100644
--- a/src/doc/src/reference/manifest.md
+++ b/src/doc/src/reference/manifest.md
@@ -209,7 +209,9 @@ description = "A short description of my package"
 ### The `documentation` field
 
 The `documentation` field specifies a URL to a website hosting the crate's
-documentation.
+documentation. If no URL is specified in the manifest file, [crates.io] will
+automatically link your crate to the corresponding [docs.rs] page when the
+documentation has been built and is available (see [docs.rs queue]).
 
 ```toml
 [package]
@@ -217,6 +219,8 @@ documentation.
 documentation = "https://docs.rs/bitflags"
 ```
 
+[docs.rs queue]: https://docs.rs/releases/queue
+
 ### The `readme` field
 
 The `readme` field should be the path to a file in the package root (relative