diff --git a/futures-core/src/task/poll.rs b/futures-core/src/task/poll.rs
index 607e78e060..bde0f8a5fe 100644
--- a/futures-core/src/task/poll.rs
+++ b/futures-core/src/task/poll.rs
@@ -1,6 +1,9 @@
-/// Extracts the successful type of a `Poll<T>`.
+/// Extracts the successful type of `Poll<T>`.
 ///
 /// This macro bakes in propagation of `Pending` signals by returning early.
+///
+/// **Note:** Since Rust 1.64, this macro is soft-deprecated in favor of
+/// [`ready!`](core::task::ready) macro in the standard library.
 #[macro_export]
 macro_rules! ready {
     ($e:expr $(,)?) => {