diff --git a/docs/integrations/python.md b/docs/integrations/python.md
index 7f8bf0083d1..19b69714862 100644
--- a/docs/integrations/python.md
+++ b/docs/integrations/python.md
@@ -12,6 +12,10 @@ redirect_from:
 
 {% include toc_2-3.html %}
 
+{: .warning }
+> If you are still using the [legacy Python `lakefs-client`][legacy-pypi], it's
+> time to upgrade!  This client is [deprecated][legacy-deprecated] and will be removed
+> soon.
 
 **High Level Python SDK**  <span class="badge mr-1">New</span>
 We've just released a new High Level Python SDK library, and we're super excited to tell you about it! Continue reading to get the
@@ -19,7 +23,7 @@ full story!
 Though our previous SDK client is still supported and maintained, we highly recommend using the new High Level SDK.
 **For previous Python SDKs follow these links:**
 [lakefs-sdk](https://pydocs-sdk.lakefs.io)
-[legacy-sdk](https://pydocs.lakefs.io) (Depracated)
+[legacy-sdk](https://pydocs.lakefs.io) (Deprecated)
 {: .note }
 
 There are three primary ways to work with lakeFS from Python:
@@ -604,3 +608,6 @@ s3.head_object(Bucket='example-repo', Key='main/example-file.parquet')
 # 'ETag': '"2398bc5880e535c61f7624ad6f138d62"',
 # 'Metadata': {}}
 ```
+
+[legacy-deprecated]:  /posts/deprecate-py-legacy.html
+[legacy-pypi]:  https://pypi.org/project/lakefs-client/
diff --git a/docs/posts/deprecate-py-legacy.md b/docs/posts/deprecate-py-legacy.md
index 7390ab21acd..4dbef3547e5 100644
--- a/docs/posts/deprecate-py-legacy.md
+++ b/docs/posts/deprecate-py-legacy.md
@@ -4,7 +4,7 @@ date: 2024-10-28
 search_exclude: true
 ---
 
-# :warning:  Deprecating `lakefs-client`, the legacy Python :snake: Client SDKs
+# ⚠️  Deprecating `lakefs-client`, the legacy Python 🐍 Client SDKs
 
 `lakefs-client` is now deprecated, and we will shortly publish its last
 release to PyPI.