address comments

Author: SebastianOuslis

pandas/core/groupby/groupby.py

@@ -3664,7 +3664,7 @@ def rolling(
             Interval of the moving window.
 
             If an integer, the delta between the start and end of each window.
-            Example: window = 3 interval from 1 -> 4
+            The number of points in the window depends on the ``closed`` argument.
 
             If a timedelta, str, or offset, the time period of each window. Each
             window will be a variable sized based on the observations included in
@@ -3711,17 +3711,18 @@ def rolling(
 
         closed : str, default None
             Determines the inclusivity of points in the window
-            If ``'right'``, (First, Last] the last point in the window
+
+            If ``'right'``, uses the window (first, last] meaning the last point
             is included in the calculations.
 
-            If ``'left'``, [First, Last) the first point in the window
+            If ``'left'``, uses the window [first, last) meaning the first point
             is included in the calculations.
 
-            If ``'both'``, [First, Last] all points in the window
-            are included in the calculations.
+            If ``'both'``, uses the window [first, last] meaning all points in 
+            the window are included in the calculations.
 
-            If ``'neither'``, (First, Last) the first and last points
-            in the window are excludedfrom calculations.
+            If ``'neither'``, uses the window (first, last) meaning the first 
+            and last points in the window are excluded from calculations.
 
             () and [] are referencing open and closed set
             notation respetively.

pandas/core/window/rolling.py

@@ -884,7 +884,7 @@ class Window(BaseWindow):
         Interval of the moving window.
 
         If an integer, the delta between the start and end of each window.
-        Example: window = 3 interval from 1 -> 4
+        The number of points in the window depends on the ``closed`` argument.
 
         If a timedelta, str, or offset, the time period of each window. Each
         window will be a variable sized based on the observations included in
@@ -930,17 +930,18 @@ class Window(BaseWindow):
 
     closed : str, default None
         Determines the inclusivity of points in the window
-        If ``'right'``, (First, Last] the last point in the window
+
+        If ``'right'``, uses the window (first, last] meaning the last point
         is included in the calculations.
 
-        If ``'left'``, [First, Last) the first point in the window
+        If ``'left'``, uses the window [first, last) meaning the first point
         is included in the calculations.
 
-        If ``'both'``, [First, Last] all points in the window
-        are included in the calculations.
+        If ``'both'``, uses the window [first, last] meaning all points in 
+        the window are included in the calculations.
 
-        If ``'neither'``, (First, Last) the first and last points
-        in the window are excludedfrom calculations.
+        If ``'neither'``, uses the window (first, last) meaning the first 
+        and last points in the window are excluded from calculations.
 
         () and [] are referencing open and closed set
         notation respetively.