DOC: add use cases / when to use PeriodIndex vs. DatetimeIndex
Maybe it makes sense to improve the documentation on the distinction of PeriodIndex vs. DatetimeIndex, especially regarding resampling behaviour.

example: https://github.com/pandas-dev/pandas/issues/10449