DOC: docstring for PeriodIndex
Merge pull request #7721 from cpcloud/period-index-docstring

DOC: docstring for PeriodIndex