diff --git a/src/libcore/macros.rs b/src/libcore/macros.rs
index 260d974e45d..b0c79a3a885 100644
--- a/src/libcore/macros.rs
+++ b/src/libcore/macros.rs
@@ -36,7 +36,8 @@ macro_rules! panic {
 /// evaluated to `true` at runtime.
 ///
 /// Assertions are always checked in both debug and release builds, and cannot
-/// be disabled.
+/// be disabled. See `debug_assert!` for assertions that are not enabled in
+/// release builds by default.
 ///
 /// Unsafe code relies on `assert!` to enforce run-time invariants that, if
 /// violated could lead to unsafety.