diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 7953375ee150df8..fd5ad158447984b 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -2110,6 +2110,11 @@ are always available.  They are listed here in alphabetical order.
    in the same way that keywords in a class
    definition (besides *metaclass*) would.
 
+   Unlike a :keyword:`class` statement, the three argument form does not
+   call the metaclass ``__prepare__`` method (see :ref:`prepare`).  Use
+   :func:`types.new_class` to dynamically create a class using the
+   appropriate metaclass.
+
    See also :ref:`class-customization`.
 
    .. versionchanged:: 3.6