From 96702da9449e0908d2e11cb2c687e072852a6e74 Mon Sep 17 00:00:00 2001
From: Jordan Murphy <35613487+jordan-d-murphy@users.noreply.github.com>
Date: Sun, 25 Feb 2024 01:43:16 -0700
Subject: [PATCH 1/2] fix SA01 error for pandas.ArrowDtype, and update link to
 :ref: format

---
 ci/code_checks.sh            | 1 -
 pandas/core/dtypes/dtypes.py | 6 +++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/ci/code_checks.sh b/ci/code_checks.sh
index 47a2cf93a4f89..7f5f2f2d406fc 100755
--- a/ci/code_checks.sh
+++ b/ci/code_checks.sh
@@ -2152,7 +2152,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
 
     MSG='Partially validate docstrings (SA01)' ;  echo $MSG
     $BASE_DIR/scripts/validate_docstrings.py --format=actions --errors=SA01 --ignore_functions \
-        pandas.ArrowDtype\
         pandas.BooleanDtype\
         pandas.Categorical.__array__\
         pandas.Categorical.as_ordered\
diff --git a/pandas/core/dtypes/dtypes.py b/pandas/core/dtypes/dtypes.py
index 12dcd8b0d42af..b456bf5c44513 100644
--- a/pandas/core/dtypes/dtypes.py
+++ b/pandas/core/dtypes/dtypes.py
@@ -2062,7 +2062,7 @@ class ArrowDtype(StorageExtensionDtype):
     Parameters
     ----------
     pyarrow_dtype : pa.DataType
-        An instance of a `pyarrow.DataType <https://arrow.apache.org/docs/python/api/datatypes.html#factory-functions>`__.
+        An instance of a :ref:`pyarrow.DataType<datatypes.factory-functions>`.
 
     Attributes
     ----------
@@ -2076,6 +2076,10 @@ class ArrowDtype(StorageExtensionDtype):
     -------
     ArrowDtype
 
+    See Also
+    --------
+    DataFrame.convert_dtypes : Convert columns to the best possible dtypes.
+
     Examples
     --------
     >>> import pyarrow as pa

From e6e89338ac3ade83db870a7faaad8ba203fda2d8 Mon Sep 17 00:00:00 2001
From: Jordan Murphy <35613487+jordan-d-murphy@users.noreply.github.com>
Date: Sun, 25 Feb 2024 02:34:11 -0700
Subject: [PATCH 2/2] revert url change

---
 pandas/core/dtypes/dtypes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pandas/core/dtypes/dtypes.py b/pandas/core/dtypes/dtypes.py
index b456bf5c44513..02560f54e2960 100644
--- a/pandas/core/dtypes/dtypes.py
+++ b/pandas/core/dtypes/dtypes.py
@@ -2062,7 +2062,7 @@ class ArrowDtype(StorageExtensionDtype):
     Parameters
     ----------
     pyarrow_dtype : pa.DataType
-        An instance of a :ref:`pyarrow.DataType<datatypes.factory-functions>`.
+        An instance of a `pyarrow.DataType <https://arrow.apache.org/docs/python/api/datatypes.html#factory-functions>`__.
 
     Attributes
     ----------