DOC: fix docstring validation errors for pandas.PeriodIndex

[hlakams]

Pandas version checks

• I have checked that the issue still exists on the latest versions of the docs on main here

Location of the documentation

pandas/ci/code_checks.sh

Lines 85 to 104 in ef3368a

	-i "pandas.PeriodIndex.day_of_week SA01" \
	-i "pandas.PeriodIndex.day_of_year SA01" \
	-i "pandas.PeriodIndex.dayofweek SA01" \
	-i "pandas.PeriodIndex.dayofyear SA01" \
	-i "pandas.PeriodIndex.days_in_month SA01" \
	-i "pandas.PeriodIndex.daysinmonth SA01" \
	-i "pandas.PeriodIndex.from_fields PR07,SA01" \
	-i "pandas.PeriodIndex.from_ordinals SA01" \
	-i "pandas.PeriodIndex.hour SA01" \
	-i "pandas.PeriodIndex.is_leap_year SA01" \
	-i "pandas.PeriodIndex.minute SA01" \
	-i "pandas.PeriodIndex.month SA01" \
	-i "pandas.PeriodIndex.quarter SA01" \
	-i "pandas.PeriodIndex.qyear GL08" \
	-i "pandas.PeriodIndex.second SA01" \
	-i "pandas.PeriodIndex.to_timestamp RT03,SA01" \
	-i "pandas.PeriodIndex.week SA01" \
	-i "pandas.PeriodIndex.weekday SA01" \
	-i "pandas.PeriodIndex.weekofyear SA01" \
	-i "pandas.PeriodIndex.year SA01" \

Documentation problem

pandas has GL08, PR07, RT03, and SA01 docstring validation issues in the pandas.PeriodIndex class.

Suggested fix for documentation

I am working on this issue and will have a fix out soon - opened here for clarity.

[hlakams]

take