diff --git a/src/task/task.rs b/src/task/task.rs
index c0d52db5..8ffe821c 100644
--- a/src/task/task.rs
+++ b/src/task/task.rs
@@ -46,6 +46,9 @@ impl fmt::Debug for Task {
 
 /// A handle that awaits the result of a task.
 ///
+/// Dropping a [`JoinHandle`] will detach the task, meaning that there is no longer
+/// a handle to the task and no way to `join` on it.
+///
 /// Created when a task is [spawned].
 ///
 /// [spawned]: fn.spawn.html