diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
index 60d01055b79..7d4bf4facf8 100644
--- a/Doc/library/imp.rst
+++ b/Doc/library/imp.rst
@@ -1,5 +1,5 @@
-:mod:`imp` --- Access the :keyword:`import` internals
-=====================================================
+:mod:`imp` --- Access the :ref:`import <importsystem>` internals
+================================================================
 
 .. module:: imp
    :synopsis: Access the implementation of the import statement.
@@ -11,6 +11,10 @@ This module provides an interface to the mechanisms used to implement the
 :keyword:`import` statement.  It defines the following constants and functions:
 
 
+.. note::
+   New programs should use :mod:`importlib` rather than this module.
+
+
 .. function:: get_magic()
 
    .. index:: pair: file; byte-code