Add caveat about default session (#4157)

* Add caveat about default session --------- Co-authored-by: jonathan343 <[email protected]>
boto · Jun 5, 2024 · 3ef0a29 · 3ef0a29
1 parent 5fa0033
commit 3ef0a29
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/source/guide/clients.rst b/docs/source/guide/clients.rst
@@ -132,6 +132,12 @@ which may interact with boto3’s client. The majority of users will not
 need to use these interfaces, but those that do should no longer
 consider their clients thread-safe without careful review.
 
+.. note::
+    ``boto3.client('<service_name>')`` is an alias for creating a client with a
+    shared default session. Invoking ``boto3.client()`` inside of a concurrent
+    context may result in response ordering issues or interpreter failures
+    from underlying SSL modules.
+
 General Example
 ~~~~~~~~~~~~~~~