#17135: Add note in imp to use importlib for new programs.
diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
index 60d0105..7d4bf4f 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 @@
: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