diff --git a/tokio-process/README.md b/tokio-process/README.md
index 9a252d9de..b48baa9b3 100644
--- a/tokio-process/README.md
+++ b/tokio-process/README.md
@@ -2,6 +2,12 @@
 
 An implementation of process management for Tokio
 
+> This crate has been **deprecated in tokio 0.2.x** and has been moved into
+> [`tokio::process`] behind the `process` [feature flag].
+
+[`tokio::process`]: https://docs.rs/tokio/latest/tokio/process/index.html
+[feature flag]: https://docs.rs/tokio/latest/tokio/index.html#feature-flags
+
 [Documentation](https://docs.rs/tokio-process/0.2.4/tokio_process)
 
 ## Usage
diff --git a/tokio-process/src/lib.rs b/tokio-process/src/lib.rs
index e9e963689..a9284f908 100644
--- a/tokio-process/src/lib.rs
+++ b/tokio-process/src/lib.rs
@@ -1,5 +1,11 @@
 //! An implementation of asynchronous process management for Tokio.
 //!
+//! > This crate has been **deprecated in tokio 0.2.x** and has been moved into
+//! > [`tokio::process`] behind the `process` [feature flag].
+//!
+//! [`tokio::process`]: https://docs.rs/tokio/latest/tokio/process/index.html
+//! [feature flag]: https://docs.rs/tokio/latest/tokio/index.html#feature-flags
+//!
 //! This crate provides a `CommandExt` trait to enhance the functionality of the
 //! `Command` type in the standard library. The three methods provided by this
 //! trait mirror the "spawning" methods in the standard library. The