1 files changed, 8 insertions, 1 deletions
diff --git a/src/rustdoc/astsrv.rs b/src/rustdoc/astsrv.rs
index d589cba107b..4bdf4498d63 100644
--- a/src/rustdoc/astsrv.rs
+++ b/src/rustdoc/astsrv.rs
@@ -1,4 +1,11 @@
-#[doc = "Provides all access to AST-related, non-sendable info"];
+#[doc(
+    brief = "Provides all access to AST-related, non-sendable info",
+    desc =
+    "Rustdoc is intended to be parallel, and the rustc AST is filled \
+     with shared boxes. The AST service attempts to provide a single \
+     place to query AST-related information, shielding the rest of \
+     Rustdoc from its non-sendableness."
+)];
 
 import rustc::syntax::ast;
 import rustc::middle::ast_map;