CLN: Resolve comments from @arw2019

Alias dep. function instead of extra property
Remove comments from test files

Author: abhishekmangla

pandas/_libs/tslibs/period.pyx

@@ -1475,6 +1475,9 @@ cdef class _Period(PeriodMixin):
         PeriodDtypeBase _dtype
         BaseOffset freq
 
+    # Alias dayofweek function to day_of_week (GH-9606)
+    dayofweek = _Period.day_of_week
+
     def __cinit__(self, int64_t ordinal, BaseOffset freq):
         self.ordinal = ordinal
         self.freq = freq
@@ -1932,11 +1935,6 @@ cdef class _Period(PeriodMixin):
         base = self._dtype._dtype_code
         return pweekday(self.ordinal, base)
 
-    @property
-    def dayofweek(self) -> int:
-        """This property is deprecated. Please use day_of_week instead."""
-        return self.day_of_week
-
     @property
     def weekday(self) -> int:
         """

pandas/_libs/tslibs/timestamps.pyx

@@ -230,6 +230,8 @@ cdef class _Timestamp(ABCTimestamp):
 
     # higher than np.ndarray and np.matrix
     __array_priority__ = 100
+    # Alias dayofweek function to day_of_week (GH-9606)
+    dayofweek = _Timestamp.day_of_week
 
     def __hash__(_Timestamp self):
         if self.nanosecond:
@@ -544,13 +546,6 @@ cdef class _Timestamp(ABCTimestamp):
         """
         return self.weekday()
 
-    @property
-    def dayofweek(self) -> int:
-        """
-        Deprecated. Use day_of_week instead.
-        """
-        return self.day_of_week
-
     @property
     def dayofyear(self) -> int:
         """

pandas/tests/generic/test_finalize.py

@@ -678,7 +678,6 @@ def test_datetime_method(method):
         "microsecond",
         "nanosecond",
         "dayofweek",
-        # Add better named field for GH-9606
         "day_of_week",
         "dayofyear",
         "quarter",

pandas/tests/indexes/datetimes/test_scalar_compat.py

@@ -38,7 +38,6 @@ def test_dti_date_out_of_range(self, data):
         "field",
         [
             "dayofweek",
-            # Add better named field for GH-9606
             "day_of_week",
             "dayofyear",
             "quarter",

pandas/tests/indexes/period/test_period.py

@@ -249,7 +249,6 @@ def _check_all_fields(self, periodindex):
             "weekofyear",
             "week",
             "dayofweek",
-            # Add better named field for GH-9606
             "day_of_week",
             "dayofyear",
             "quarter",