DOC: Improved doc string for IntervalIndex + related changes
- [x ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

This PR has Improvements for the doc string for ``IntervalIndex`` + related changes