DOC: Enforce Numpy Docstring Validation for pandas.Timestamp.as_unit and pandas.Timedelta.as_unit (#58609)

* DOC: add SA01 for pandas.Timestamp.as_unit

* DOC: remove SA01 for pandas.Timestamp.as_unit

* DOC: add SA01 for pandas.Timedelta.as_unit

* DOC: remove SA01 for pandas.Timedelta.as_unit

* DOC: remove SA01 for pandas.Timedelta.as_unit

Author: tuhinsharma121

ci/code_checks.sh

@@ -281,7 +281,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.TimedeltaIndex.nanoseconds SA01" \
         -i "pandas.TimedeltaIndex.seconds SA01" \
         -i "pandas.TimedeltaIndex.to_pytimedelta RT03,SA01" \
-        -i "pandas.Timestamp.as_unit SA01" \
         -i "pandas.Timestamp.asm8 SA01" \
         -i "pandas.Timestamp.astimezone SA01" \
         -i "pandas.Timestamp.ceil SA01" \

pandas/_libs/tslibs/nattype.pyx

@@ -1383,6 +1383,14 @@ default 'raise'
         -------
         Timestamp
 
+        See Also
+        --------
+        Timestamp.asm8 : Return numpy datetime64 format in nanoseconds.
+        Timestamp.to_pydatetime : Convert Timestamp object to a native
+            Python datetime object.
+        to_timedelta : Convert argument into timedelta object,
+            which can represent differences in times.
+
         Examples
         --------
         >>> ts = pd.Timestamp('2023-01-01 00:00:00.01')

pandas/_libs/tslibs/timestamps.pyx

@@ -1115,6 +1115,14 @@ cdef class _Timestamp(ABCTimestamp):
         -------
         Timestamp
 
+        See Also
+        --------
+        Timestamp.asm8 : Return numpy datetime64 format in nanoseconds.
+        Timestamp.to_pydatetime : Convert Timestamp object to a native
+            Python datetime object.
+        to_timedelta : Convert argument into timedelta object,
+            which can represent differences in times.
+
         Examples
         --------
         >>> ts = pd.Timestamp('2023-01-01 00:00:00.01')