From 4119ffb168d07dc1ab340da0a2a6d35c6e1e166f Mon Sep 17 00:00:00 2001
From: Kaverin Maxim <mvkaverin@edu.hse.ru>
Date: Wed, 20 Nov 2024 17:34:59 +0300
Subject: [PATCH 1/2] Added docs for Series.dt.freq and removed from
 ci/code_checks.sh

---
 ci/code_checks.sh                |  1 -
 pandas/core/indexes/accessors.py | 26 ++++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/ci/code_checks.sh b/ci/code_checks.sh
index 53690e9b78b8a..36a7ed1910221 100755
--- a/ci/code_checks.sh
+++ b/ci/code_checks.sh
@@ -73,7 +73,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.Period.freq GL08" \
         -i "pandas.Period.ordinal GL08" \
         -i "pandas.RangeIndex.from_range PR01,SA01" \
-        -i "pandas.Series.dt.freq GL08" \
         -i "pandas.Series.dt.unit GL08" \
         -i "pandas.Series.pad PR01,SA01" \
         -i "pandas.Timedelta.max PR02" \
diff --git a/pandas/core/indexes/accessors.py b/pandas/core/indexes/accessors.py
index e2dc71f68a65b..2f8e9d350e478 100644
--- a/pandas/core/indexes/accessors.py
+++ b/pandas/core/indexes/accessors.py
@@ -373,6 +373,32 @@ def to_pydatetime(self) -> Series:
 
     @property
     def freq(self):
+        """
+        Tries to return a string representing a frequency generated by infer_freq.
+
+        Returns None if it can't autodetect the frequency.
+
+        See Also
+        --------
+        Series.dt.to_period : Cast to PeriodArray/PeriodIndex at a particular
+            frequency.
+
+        Examples
+        --------
+        >>> ser = pd.Series(
+        ...     ["2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04"]
+        ... )
+        >>> ser = pd.to_datetime(ser)
+        >>> ser.dt.freq
+        'D'
+
+        >>> ser = pd.Series(
+        ...     ["2022-01-01", "2024-01-01", "2026-01-01", "2028-01-01"]
+        ... )
+        >>> ser = pd.to_datetime(ser)
+        >>> ser.dt.freq
+        '2YS-JAN'
+        """
         return self._get_values().inferred_freq
 
     def isocalendar(self) -> DataFrame:

From 84e93a18e567ed4afe768dd9b959945b5d2509b3 Mon Sep 17 00:00:00 2001
From: Kaverin Maxim <mvkaverin@edu.hse.ru>
Date: Wed, 20 Nov 2024 17:55:18 +0300
Subject: [PATCH 2/2] Fix code style

---
 pandas/core/indexes/accessors.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/pandas/core/indexes/accessors.py b/pandas/core/indexes/accessors.py
index 2f8e9d350e478..c404323a1168c 100644
--- a/pandas/core/indexes/accessors.py
+++ b/pandas/core/indexes/accessors.py
@@ -385,16 +385,12 @@ def freq(self):
 
         Examples
         --------
-        >>> ser = pd.Series(
-        ...     ["2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04"]
-        ... )
+        >>> ser = pd.Series(["2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04"])
         >>> ser = pd.to_datetime(ser)
         >>> ser.dt.freq
         'D'
 
-        >>> ser = pd.Series(
-        ...     ["2022-01-01", "2024-01-01", "2026-01-01", "2028-01-01"]
-        ... )
+        >>> ser = pd.Series(["2022-01-01", "2024-01-01", "2026-01-01", "2028-01-01"])
         >>> ser = pd.to_datetime(ser)
         >>> ser.dt.freq
         '2YS-JAN'