DOC: Enforce Numpy Docstring Validation for pandas.Interval.right pandas.Interval.left pandas.Interval.closed (#58571)

* DOC: add SA01 for pandas.Interval.closed

* DOC: remove SA01 for pandas.Interval.closed

* DOC: add SA01 for pandas.Interval.closed

* DOC: add SA01 for pandas.Interval.left

* DOC: remove SA01 for pandas.Interval.left

* DOC: add SA01 for pandas.Interval.right

* DOC: remove SA01 for pandas.Interval.right

Author: tuhinsharma121

ci/code_checks.sh

@@ -87,9 +87,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.Index.ravel PR01,RT03" \
         -i "pandas.Index.str PR01,SA01" \
         -i "pandas.Interval PR02" \
-        -i "pandas.Interval.closed SA01" \
-        -i "pandas.Interval.left SA01" \
-        -i "pandas.Interval.right SA01" \
         -i "pandas.IntervalIndex.closed SA01" \
         -i "pandas.IntervalIndex.contains RT03" \
         -i "pandas.IntervalIndex.get_loc PR07,RT03,SA01" \

pandas/_libs/interval.pyx

@@ -383,6 +383,12 @@ cdef class Interval(IntervalMixin):
     """
     Left bound for the interval.
 
+    See Also
+    --------
+    Interval.right : Return the right bound for the interval.
+    numpy.ndarray.left : A similar method in numpy for obtaining
+        the left endpoint(s) of intervals.
+
     Examples
     --------
     >>> interval = pd.Interval(left=1, right=2, closed='left')
@@ -396,6 +402,12 @@ cdef class Interval(IntervalMixin):
     """
     Right bound for the interval.
 
+    See Also
+    --------
+    Interval.left : Return the left bound for the interval.
+    numpy.ndarray.right : A similar method in numpy for obtaining
+        the right endpoint(s) of intervals.
+
     Examples
     --------
     >>> interval = pd.Interval(left=1, right=2, closed='left')
@@ -411,6 +423,13 @@ cdef class Interval(IntervalMixin):
 
     Either ``left``, ``right``, ``both`` or ``neither``.
 
+    See Also
+    --------
+    Interval.closed_left : Check if the interval is closed on the left side.
+    Interval.closed_right : Check if the interval is closed on the right side.
+    Interval.open_left : Check if the interval is open on the left side.
+    Interval.open_right : Check if the interval is open on the right side.
+
     Examples
     --------
     >>> interval = pd.Interval(left=1, right=2, closed='left')