DOC: Closed parameter not intuitively documented in DataFrame.rolling (…

…#60832) * change docs * format * format
pandas-dev · Feb 3, 2025 · c6fc6d0 · c6fc6d0
1 parent 3bd27ff
commit c6fc6d0
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 10 deletions.
diff --git a/pandas/core/groupby/groupby.py b/pandas/core/groupby/groupby.py
@@ -3717,14 +3717,21 @@ def rolling(
             an integer index is not used to calculate the rolling window.
 
         closed : str, default None
-            If ``'right'``, the first point in the window is excluded from calculations.
+            Determines the inclusivity of points in the window
+            If ``'right'``, (First, Last] the last point in the window
+            is included in the calculations.
 
-            If ``'left'``, the last point in the window is excluded from calculations.
+            If ``'left'``, [First, Last) the first point in the window
+            is included in the calculations.
 
-            If ``'both'``, no points in the window are excluded from calculations.
+            If ``'both'``, [First, Last] all points in the window
+            are included in the calculations.
 
-            If ``'neither'``, the first and last points in the window are excluded
-            from calculations.
+            If ``'neither'``, (First, Last) the first and last points
+            in the window are excludedfrom calculations.
+
+            () and [] are referencing open and closed set
+            notation respetively.
 
             Default ``None`` (``'right'``).
 

diff --git a/pandas/core/window/rolling.py b/pandas/core/window/rolling.py
@@ -929,14 +929,21 @@ class Window(BaseWindow):
         an integer index is not used to calculate the rolling window.
 
     closed : str, default None
-        If ``'right'``, the first point in the window is excluded from calculations.
+        Determines the inclusivity of points in the window
+        If ``'right'``, (First, Last] the last point in the window
+        is included in the calculations.
 
-        If ``'left'``, the last point in the window is excluded from calculations.
+        If ``'left'``, [First, Last) the first point in the window
+        is included in the calculations.
 
-        If ``'both'``, no point in the window is excluded from calculations.
+        If ``'both'``, [First, Last] all points in the window
+        are included in the calculations.
 
-        If ``'neither'``, the first and last points in the window are excluded
-        from calculations.
+        If ``'neither'``, (First, Last) the first and last points
+        in the window are excludedfrom calculations.
+
+        () and [] are referencing open and closed set
+        notation respetively.
 
         Default ``None`` (``'right'``).