Fix docstrings for pandas.Period.month
Part of https://github.com/pandas-dev/pandas/issues/59458

Addresses:
pandas.Period.month having SA01
pandas.Period.asfreq SA01


Changes:
Added See Also section .
Added Returns section .
Added extended section .
Added notes section .
Added examples section .
Removed  "pandas.Period.month SA01" and "pandas.Period.asfreq SA01" from code_checks.sh
thnx, please check ci failure Thanks @uditbaliyan 