Fix docstrings for pandas.Period.year SA01
Part of #59458

Addresses:
pandas.Period.year having SA01

Changes:
Added See Also section .
Added Returns section .
Added extended section .
Added notes section .
Added examples section .
Removed "pandas.Period.year SA01"  from code_checks.sh
Thanks @uditbaliyan 