diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 286641dee813..a1dd5adbef34 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -1602,14 +1602,12 @@ def _replacer(data, key):
 
 _DATA_DOC_APPENDIX = """
 
-Notes
------
+.. note::
+    In addition to the above described arguments, this function can take a
+    **data** keyword argument. If such a **data** argument is given, the
+    following arguments are replaced by **data[<arg>]**:
 
-In addition to the above described arguments, this function can take a
-**data** keyword argument. If such a **data** argument is given, the
-following arguments are replaced by **data[<arg>]**:
-
-{replaced}
+    {replaced}
 """
 
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index f042ee2be7cf..232e5de33705 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4676,7 +4676,8 @@ def barbs(self, *args, **kw):
                         positional_parameter_names=["x", "y", "c"])
     @docstring.dedent_interpd
     def fill(self, *args, **kwargs):
-        """Plot filled polygons.
+        """
+        Plot filled polygons.
 
         Parameters
         ----------