Fixed docstring errors in pandas.period range and pandas.PeriodIndex
- [x] addresses #28724 
- [x] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff

Thanks @anirudnits 