DOC: update docstrings of Interval's attributes

[abonte]

Added See Also and/or Examples sections in the docstrings of Interval's attributes:

closed_left, output from `validate_docstrings.py`

################################################################################ ################### Docstring (pandas.Interval.closed_left) ################### ################################################################################ Check if the interval is closed on the left side. For the meaning of `closed` and `open` see :class:`~pandas.Interval`. Returns ------- 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 ################################################################################ ################################## Validation ################################## ################################################################################ Docstring for "pandas.Interval.closed_left" correct. :) 

closed_right, output from `validate_docstrings.py`

################################################################################ ################### Docstring (pandas.Interval.closed_right) ################### ################################################################################ Check if the interval is closed on the right side. For the meaning of `closed` and `open` see :class:`~pandas.Interval`. Returns ------- 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 ################################################################################ ################################## Validation ################################## ################################################################################ Docstring for "pandas.Interval.closed_right" correct. :) 

open_left, output from `validate_docstrings.py`

################################################################################ #################### Docstring (pandas.Interval.open_left) #################### ################################################################################ Check if the interval is open on the left side. For the meaning of `closed` and `open` see :class:`~pandas.Interval`. Returns ------- 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 ################################################################################ ################################## Validation ################################## ################################################################################ Docstring for "pandas.Interval.open_left" correct. :) 

open_right, output from `validate_docstrings.py`

################################################################################ #################### Docstring (pandas.Interval.open_right) #################### ################################################################################ Check if the interval is open on the right side. For the meaning of `closed` and `open` see :class:`~pandas.Interval`. Returns ------- 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 ################################################################################ ################################## Validation ################################## ################################################################################ Docstring for "pandas.Interval.open_right" correct. :) 

length, output from `validate_docstrings.py`

################################################################################ ###################### Docstring (pandas.Interval.length) ###################### ################################################################################ Return the length of the Interval. See Also -------- Interval.is_empty : Indicates if an interval contains no points. ################################################################################ ################################## Validation ################################## ################################################################################ 2 Errors found: No extended summary found No examples section found </p> 

is_empty, output from `validate_docstrings.py`

################################################################################ ##################### Docstring (pandas.Interval.is_empty) ##################### ################################################################################ Indicates if an interval is empty, meaning it contains no points. Returns ------- bool or ndarray A boolean indicating if a scalar :class:`Interval` is empty, or a boolean ``ndarray`` positionally indicating if an ``Interval`` in 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: >>> pd.Interval(0, 1, closed='right').is_empty False An ``Interval`` that does not contain any points is empty: >>> pd.Interval(0, 0, closed='right').is_empty True >>> pd.Interval(0, 0, closed='left').is_empty True >>> pd.Interval(0, 0, closed='neither').is_empty True An ``Interval`` that contains a single point is not empty: >>> pd.Interval(0, 0, closed='both').is_empty False An :class:`~arrays.IntervalArray` or :class:`IntervalIndex` returns a boolean ``ndarray`` positionally indicating if an ``Interval`` is empty: >>> ivs = [pd.Interval(0, 0, closed='neither'), ... pd.Interval(1, 2, closed='neither')] >>> pd.arrays.IntervalArray(ivs).is_empty array([ True, False]) Missing values are not considered empty: >>> ivs = [pd.Interval(0, 0, closed='neither'), np.nan] >>> pd.IntervalIndex(ivs).is_empty array([ True, False]) ################################################################################ ################################## Validation ################################## ################################################################################ 1 Errors found: No extended summary found 

• xref DOC: overall improvement of docstrings #15580 DOC: Fix EX01 issues in docstrings #37875
• Tests added and passed if fixing a bug or adding a new feature na
• All code checks passed.
• Added type annotations to new arguments/methods/functions. na
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature. na

[gfyoung]

cc @phofl since you reviewed one of @abonte other doc PRs

[phofl]

thx @abonte