From 20b2d01e984b28b2017e2937a0f8c531d875f4cf Mon Sep 17 00:00:00 2001
From: Eric Zhu <73148494+ericfzhu@users.noreply.github.com>
Date: Tue, 25 Nov 2025 21:37:10 +1100
Subject: [PATCH 1/2] Add compatibility notice for sagemaker notebook al2-v3

---
 docs/source/install.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/source/install.rst b/docs/source/install.rst
index 2f16e5a16..4abb3ba42 100644
--- a/docs/source/install.rst
+++ b/docs/source/install.rst
@@ -250,6 +250,15 @@ Run this command in any Python 3 notebook cell and then make sure to
 
     >>> !pip install awswrangler
 
+**Platform compatibility notice:**
+
+* ``awswrangler>=3.14.0`` requires **AL2023-v1 or later** notebook instances
+* If using AL2-V3, pin to an older version:
+
+    >>> !pip install "awswrangler<3.14.0"
+
+This is due to AL2-V3 not meeting the build requirements for PyArrow 21.0.0+ (CMake 3.25+).
+
 Amazon SageMaker Notebook Lifecycle
 -----------------------------------
 

From 55ec2eb358b62fd9b28ea58ab535dd4ade5ded5b Mon Sep 17 00:00:00 2001
From: Eric Zhu <73148494+ericfzhu@users.noreply.github.com>
Date: Wed, 26 Nov 2025 15:05:07 +1100
Subject: [PATCH 2/2] Reworded notice to better describe the actual issue
 (CMake version compatibility) and possible solutions

---
 docs/source/install.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/source/install.rst b/docs/source/install.rst
index 4abb3ba42..7b84ac2ff 100644
--- a/docs/source/install.rst
+++ b/docs/source/install.rst
@@ -252,12 +252,14 @@ Run this command in any Python 3 notebook cell and then make sure to
 
 **Platform compatibility notice:**
 
-* ``awswrangler>=3.14.0`` requires **AL2023-v1 or later** notebook instances
-* If using AL2-V3, pin to an older version:
+``awswrangler>=3.14.0`` defaults to PyArrow 21.0.0+, which requires CMake 3.25+ to build. On AL2-V3 notebook instances (CMake 2.8), you have the following options:
 
-    >>> !pip install "awswrangler<3.14.0"
+* Pin PyArrow to an older version:
 
-This is due to AL2-V3 not meeting the build requirements for PyArrow 21.0.0+ (CMake 3.25+).
+    >>> !pip install awswrangler "pyarrow<21"
+
+* Upgrade CMake version to 3.25+
+* Update your notebook instance platform type to AL2023-V1 or later using ``UpdateNotebookInstance``
 
 Amazon SageMaker Notebook Lifecycle
 -----------------------------------