From 1bed4f59c9b76de8bd447e4a8579da0484b2f9d6 Mon Sep 17 00:00:00 2001
From: Tim Swast <swast@google.com>
Date: Wed, 6 Apr 2022 15:28:16 -0500
Subject: [PATCH] DOC: generate docs for the `Series.dt.isocalendar()` method.

---
 doc/source/reference/series.rst  | 1 +
 pandas/core/indexes/accessors.py | 7 ++++---
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/source/reference/series.rst b/doc/source/reference/series.rst
index a60dab549e66d..fcdc9ea9b95da 100644
--- a/doc/source/reference/series.rst
+++ b/doc/source/reference/series.rst
@@ -342,6 +342,7 @@ Datetime methods
    :toctree: api/
    :template: autosummary/accessor_method.rst
 
+   Series.dt.isocalendar
    Series.dt.to_period
    Series.dt.to_pydatetime
    Series.dt.tz_localize
diff --git a/pandas/core/indexes/accessors.py b/pandas/core/indexes/accessors.py
index a0bc0ae8e3511..26748a4342bb6 100644
--- a/pandas/core/indexes/accessors.py
+++ b/pandas/core/indexes/accessors.py
@@ -277,12 +277,13 @@ def isocalendar(self):
     @property
     def weekofyear(self):
         """
-        The week ordinal of the year.
+        The week ordinal of the year according to the ISO 8601 standard.
 
         .. deprecated:: 1.1.0
 
-        Series.dt.weekofyear and Series.dt.week have been deprecated.
-        Please use Series.dt.isocalendar().week instead.
+        Series.dt.weekofyear and Series.dt.week have been deprecated.  Please
+        call :func:`Series.dt.isocalendar` and access the ``week`` column
+        instead.
         """
         warnings.warn(
             "Series.dt.weekofyear and Series.dt.week have been deprecated. "