DOC: update docstrings of Interval's attributes (#50609)

Author: abonte

pandas/_libs/interval.pyx

@@ -58,6 +58,21 @@ cdef class IntervalMixin:
  -------
  bool
  True if the Interval is closed on the left-side.
+
+ See Also
+ --------
+ Interval.closed_right : Check if the interval is closed on the right side.
+ Interval.open_left : Boolean inverse of closed_left.
+
+ Examples
+ --------
+ >>> iv = pd.Interval(0, 5, closed='left')
+ >>> iv.closed_left
+ True
+
+ >>> iv = pd.Interval(0, 5, closed='right')
+ >>> iv.closed_left
+ False
  """
  return self.closed in ("left", "both")
 
@@ -72,6 +87,21 @@ cdef class IntervalMixin:
  -------
  bool
  True if the Interval is closed on the left-side.
+
+ See Also
+ --------
+ Interval.closed_left : Check if the interval is closed on the left side.
+ Interval.open_right : Boolean inverse of closed_right.
+
+ Examples
+ --------
+ >>> iv = pd.Interval(0, 5, closed='both')
+ >>> iv.closed_right
+ True
+
+ >>> iv = pd.Interval(0, 5, closed='left')
+ >>> iv.closed_right
+ False
  """
  return self.closed in ("right", "both")
 
@@ -86,6 +116,21 @@ cdef class IntervalMixin:
  -------
  bool
  True if the Interval is not closed on the left-side.
+
+ See Also
+ --------
+ Interval.open_right : Check if the interval is open on the right side.
+ Interval.closed_left : Boolean inverse of open_left.
+
+ Examples
+ --------
+ >>> iv = pd.Interval(0, 5, closed='neither')
+ >>> iv.open_left
+ True
+
+ >>> iv = pd.Interval(0, 5, closed='both')
+ >>> iv.open_left
+ False
  """
  return not self.closed_left
 
@@ -100,6 +145,21 @@ cdef class IntervalMixin:
  -------
  bool
  True if the Interval is not closed on the left-side.
+
+ See Also
+ --------
+ Interval.open_left : Check if the interval is open on the left side.
+ Interval.closed_right : Boolean inverse of open_right.
+
+ Examples
+ --------
+ >>> iv = pd.Interval(0, 5, closed='left')
+ >>> iv.open_right
+ True
+
+ >>> iv = pd.Interval(0, 5)
+ >>> iv.open_right
+ False
  """
  return not self.closed_right
 
@@ -124,6 +184,10 @@ cdef class IntervalMixin:
  def length(self):
  """
  Return the length of the Interval.
+
+ See Also
+ --------
+ Interval.is_empty : Indicates if an interval contains no points.
  """
  return self.right - self.left
 
@@ -140,6 +204,10 @@ cdef class IntervalMixin:
  an :class:`~arrays.IntervalArray` or :class:`IntervalIndex` is
  empty.
 
+ See Also
+ --------
+ Interval.length : Return the length of the Interval.
+
  Examples
  --------
  An :class:`Interval` that contains points is not empty: