feedback

Author: jordan-smith721

source/connect/stable-api.txt

@@ -120,4 +120,3 @@ following API documentation:
 - `MongoClient <{+api-root+}pymongo/mongo_client.html#pymongo.mongo_client.MongoClient>`__
 - `ServerApi <{+api-root+}pymongo/server_api.html#pymongo.server_api.ServerApi>`__
 - `ServerApiVersion <{+api-root+}pymongo/server_api.html#pymongo.server_api.ServerApiVersion>`__
-

source/includes/pymongo-async-experimental.rst

@@ -0,0 +1,7 @@
+.. important::
+
+   The {+driver-async+} driver is experimental and should not be used in
+   production environments. Classes, methods, and behaviors described in this
+   guide might change prior to the full release. If you encounter any
+   issues with {+driver-async+}, you can learn how to report them on the
+   :ref:`pymongo-issues-help` page.

source/index.txt

@@ -125,7 +125,7 @@ in the :ref:`pymongo-upgrade` section.
 Migrate from Motor to {+driver-async+}
 -------------------------------------
 
-In September 2024, MongoDB released the {+driver-async+} driver as a replacement
+In September 2024, MongoDB released the experimental {+driver-async+} driver as a replacement
 for `Motor <https://www.mongodb.com/docs/drivers/motor/>`__, the previous asynchronous
 MongoDB driver for Python. Learn how to migrate from Motor
 to the {+driver-async+} driver in the :ref:`pymongo-async-motor-migration`
@@ -135,7 +135,7 @@ Switch from {+driver-short+} to {+driver-async+}
 ----------------------------------------------
 
 Learn what changes you need to make to switch from {+driver-short+} to
-{+driver-async+} in the :ref:`pymongo-to-async-guide` section.
+the experimental {+driver-async+} driver in the :ref:`pymongo-to-async-guide` section.
 
 Previous Versions
 -----------------

source/motor-async-migration.txt

@@ -17,6 +17,8 @@ Migrate from Motor to {+driver-async+}
 .. meta::
    :keywords: motor, async, refactor, migration
 
+.. include:: /includes/pymongo-async-experimental.rst
+
 Overview
 --------
 
@@ -62,10 +64,13 @@ The following Motor method signatures behave differently in the {+driver-async+}
 - ``AsyncMongoClient.__init__()`` does not accept an ``io_loop`` parameter.
 - ``GridIn.set()`` does not accept a filename. Instead pass a file name by using the
   ``GridIn.filename`` attribute.
-- ``Cursor.each()`` does not exist in the {+driver-async+} driver.
-- ``stream_to_handler()`` does not exist in the {+driver-async+} driver.
-- ``to_list(0)`` is not valid in the {+driver-async+} driver. Use
+- ``AsyncCursor.each()`` does not exist in the {+driver-async+} driver.
+- ``MotorGridOut.stream_to_handler()`` does not exist in the {+driver-async+} driver.
+- ``AsyncCursor.to_list(0)`` is not valid in the {+driver-async+} driver. Use
   ``to_list(None)`` instead.
+- ``MongoClient`` is thread safe and can be used by many threads, however, an
+  ``AsyncMongoClient`` is not thread safe and should only be used by a single
+  event loop.
 
 Additional Information
 ----------------------

source/pymongo-to-async-guide.txt

@@ -17,6 +17,8 @@ Switch from {+driver-short+} to {+driver-async+}
 .. meta::
    :keywords: asyncronous, refactor, migration
 
+.. include:: /includes/pymongo-async-experimental.rst
+
 Overview
 --------