diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 74e217e8abbed3..a96f69e6170f00 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -2069,6 +2069,7 @@ are always available.  They are listed here in alphabetical order.
       >>> X = type('X', (), dict(a=1))
 
    See also:
+
    * :ref:`Documentation on attributes and methods on classes <class-attrs-and-methods>`.
    * :ref:`bltin-type-objects`
 
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index f26ad4b3155624..4e355421a725bd 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -1040,7 +1040,7 @@ Special attributes
        For best practices on working with :attr:`~object.__annotations__`,
        please see :mod:`annotationlib`.
 
-       .. warning::
+       .. caution::
 
           Accessing the :attr:`!__annotations__` attribute of a class
           object directly may yield incorrect results in the presence of
@@ -1056,7 +1056,7 @@ Special attributes
        if the class has no annotations.
        See also: :attr:`__annotate__ attributes <object.__annotate__>`.
 
-       .. warning::
+       .. caution::
 
           Accessing the :attr:`!__annotate__` attribute of a class
           object directly may yield incorrect results in the presence of