DOC: fix SA01 for pandas.Period (#58838)

Author: tuhinsharma121

ci/code_checks.sh

@@ -93,7 +93,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.NA SA01" \
         -i "pandas.NaT SA01" \
         -i "pandas.NamedAgg SA01" \
-        -i "pandas.Period SA01" \
         -i "pandas.Period.asfreq SA01" \
         -i "pandas.Period.freq GL08" \
         -i "pandas.Period.freqstr SA01" \

pandas/_libs/tslibs/period.pyx

@@ -2699,6 +2699,12 @@ class Period(_Period):
     second : int, default 0
         Second value of the period.
 
+    See Also
+    --------
+    Timestamp : Pandas replacement for python datetime.datetime object.
+    date_range : Return a fixed frequency DatetimeIndex.
+    timedelta_range : Generates a fixed frequency range of timedeltas.
+
     Examples
     --------
     >>> period = pd.Period('2012-1-1', freq='D')