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