diff --git a/src/libstd/thread/mod.rs b/src/libstd/thread/mod.rs
index 8e7eaa77cd7..9cded2ab289 100644
--- a/src/libstd/thread/mod.rs
+++ b/src/libstd/thread/mod.rs
@@ -723,7 +723,9 @@ struct Inner {
 ///
 /// # Examples
 ///
-/// ```
+/// ```no_run
+/// # // Note that this example isn't executed by default because it causes
+/// # // deadlocks on Windows unfortunately (see #25824)
 /// use std::thread::Builder;
 ///
 /// for i in 0..5 {