From 1655bfe53ed6ffb3f6a304d6dbe54f3e4faf4c9e Mon Sep 17 00:00:00 2001
From: Patrick Hoefler <61934744+phofl@users.noreply.github.com>
Date: Tue, 28 Nov 2023 16:47:17 +0100
Subject: [PATCH] Backport PR #56222: Add doc notes for deprecations

---
 pandas/core/generic.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/pandas/core/generic.py b/pandas/core/generic.py
index 3281d245dca56..564d572254f8d 100644
--- a/pandas/core/generic.py
+++ b/pandas/core/generic.py
@@ -9456,6 +9456,10 @@ def first(self, offset) -> Self:
         """
         Select initial periods of time series data based on a date offset.
 
+        .. deprecated:: 2.1
+            :meth:`.first` is deprecated and will be removed in a future version.
+            Please create a mask and filter using `.loc` instead.
+
         For a DataFrame with a sorted DatetimeIndex, this function can
         select the first few rows based on a date offset.
 
@@ -9535,6 +9539,10 @@ def last(self, offset) -> Self:
         """
         Select final periods of time series data based on a date offset.
 
+        .. deprecated:: 2.1
+            :meth:`.last` is deprecated and will be removed in a future version.
+            Please create a mask and filter using `.loc` instead.
+
         For a DataFrame with a sorted DatetimeIndex, this function
         selects the last few rows based on a date offset.