diff --git a/Doc/library/asynchat.rst b/Doc/library/asynchat.rst
index 55c61d7e68f..7050f0c5a3b 100644
--- a/Doc/library/asynchat.rst
+++ b/Doc/library/asynchat.rst
@@ -10,6 +10,9 @@
 
 --------------
 
+Note: This module exists for backwards compatibility only.  For new code we
+recommend using :module:`asyncio`.
+
 This module builds on the :mod:`asyncore` infrastructure, simplifying
 asynchronous clients and servers and making it easier to handle protocols
 whose elements are terminated by arbitrary strings, or are of variable length.
diff --git a/Doc/library/asyncore.rst b/Doc/library/asyncore.rst
index 8f494d0e58a..d0a30f8ae6c 100644
--- a/Doc/library/asyncore.rst
+++ b/Doc/library/asyncore.rst
@@ -13,6 +13,9 @@
 
 --------------
 
+Note: This module exists for backwards compatibility only.  For new code we
+recommend using :module:`asyncio`.
+
 This module provides the basic infrastructure for writing asynchronous  socket
 service clients and servers.