DOC: Fix Examples section for some window methods (#40208)

Author: mroeschke

pandas/core/window/doc.py

@@ -95,7 +95,7 @@ def create_section_header(header: str) -> str:
 
 numba_notes = (
     "See :ref:`window.numba_engine` for extended documentation "
-    "and performance considerations for the Numba engine.\n"
+    "and performance considerations for the Numba engine.\n\n"
 )
 
 window_agg_numba_parameters = dedent(

pandas/core/window/expanding.py

@@ -195,7 +195,7 @@ def apply(
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="expanding",
         aggregation_description="sum",
         agg_method="sum",
@@ -215,7 +215,7 @@ def sum(self, *args, engine=None, engine_kwargs=None, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="expanding",
         aggregation_description="maximum",
         agg_method="max",
@@ -235,7 +235,7 @@ def max(self, *args, engine=None, engine_kwargs=None, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="expanding",
         aggregation_description="minimum",
         agg_method="min",
@@ -255,7 +255,7 @@ def min(self, *args, engine=None, engine_kwargs=None, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="expanding",
         aggregation_description="mean",
         agg_method="mean",
@@ -274,7 +274,7 @@ def mean(self, *args, engine=None, engine_kwargs=None, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="expanding",
         aggregation_description="median",
         agg_method="median",
@@ -399,7 +399,7 @@ def var(self, ddof: int = 1, *args, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        "A minimum of one period is required for the calculation.\n",
+        "A minimum of one period is required for the calculation.\n\n",
         create_section_header("Examples"),
         dedent(
             """
@@ -448,7 +448,7 @@ def skew(self, **kwargs):
         "scipy.stats.kurtosis : Reference SciPy method.\n",
         template_see_also,
         create_section_header("Notes"),
-        "A minimum of four periods is required for the calculation.\n",
+        "A minimum of four periods is required for the calculation.\n\n",
         create_section_header("Examples"),
         dedent(
             """

pandas/core/window/rolling.py

@@ -1656,7 +1656,7 @@ def sum(self, *args, engine=None, engine_kwargs=None, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        numba_notes,
+        numba_notes[:-1],
         window_method="rolling",
         aggregation_description="maximum",
         agg_method="max",
@@ -1798,7 +1798,7 @@ def median(self, engine=None, engine_kwargs=None, **kwargs):
         The default ``ddof`` of 1 used in :meth:`Series.std` is different
         than the default ``ddof`` of 0 in :func:`numpy.std`.
 
-        A minimum of one period is required for the rolling calculation.
+        A minimum of one period is required for the rolling calculation.\n
         """
         ).replace("\n", "", 1),
         create_section_header("Examples"),
@@ -1847,7 +1847,7 @@ def std(self, ddof=1, *args, **kwargs):
         The default ``ddof`` of 1 used in :meth:`Series.var` is different
         than the default ``ddof`` of 0 in :func:`numpy.var`.
 
-        A minimum of one period is required for the rolling calculation.
+        A minimum of one period is required for the rolling calculation.\n
         """
         ).replace("\n", "", 1),
         create_section_header("Examples"),
@@ -1908,7 +1908,7 @@ def skew(self, **kwargs):
         create_section_header("See Also"),
         template_see_also,
         create_section_header("Notes"),
-        "A minimum of one period is required for the calculation.\n",
+        "A minimum of one period is required for the calculation.\n\n",
         create_section_header("Examples"),
         dedent(
             """
@@ -1938,7 +1938,7 @@ def sem(self, ddof=1, *args, **kwargs):
         "scipy.stats.kurtosis : Reference SciPy method.\n",
         template_see_also,
         create_section_header("Notes"),
-        "A minimum of four periods is required for the calculation.\n",
+        "A minimum of four periods is required for the calculation.\n\n",
         create_section_header("Examples"),
         dedent(
             """
@@ -2106,7 +2106,7 @@ def cov(self, other=None, pairwise=None, ddof=1, **kwargs):
         columns on the second level.
 
         In the case of missing elements, only complete pairwise observations
-        will be used.
+        will be used.\n
         """
         ).replace("\n", "", 1),
         create_section_header("Examples"),