docstring fixup

Author: jbrockmendel

pandas/core/dtypes/dtypes.py

@@ -1103,15 +1103,15 @@ def freq(self) -> BaseOffset:
         """
         The frequency object of this PeriodDtype.
 
+        .. deprecated:: 3.0
+            Use dtype.unit instead.
+
         The `freq` property returns the `BaseOffset` object that represents the
         frequency of the PeriodDtype. This frequency specifies the interval (e.g.,
         daily, monthly, yearly) associated with the Period type. It is essential
         for operations that depend on time-based calculations within a period index
         or series.
 
-        .. deprecated:: 3.0
-            Use dtype.unit instead.
-
         See Also
         --------
         Period : Represents a period of time.