DOC: update PeriodArray docstring
AFAICT we currently don't have dedicated pages for these methods in the API reference. 

When we add them we also want add links on the `pd.PeriodArray` [page](https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.arrays.PeriodArray.html) (and possibly in other places)