DOC: Modify IntervalArray/IntervalIndex docstrings to pass validate_docstrings.py
- [X] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

Didn't materially change any existing content; mostly small modifications and a couple additions.