[Backport v4.12] DOCSP-493767 Update migration admonitions to clarify release phases

source/includes/pymongo-async-experimental.rst

@@ -1,7 +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.
+   The {+driver-async+} driver is experimental. We do **not**
+   recommend using it in production environments. Classes, methods, and
+   behaviors described in this guide might change before the production release.
+   If you encounter any issues with {+driver-async+}, you can learn how to
+   report them on the :ref:`pymongo-issues-help` page.

source/reference/migration.txt

@@ -61,9 +61,12 @@ Migrate From Motor
 
 .. warning:: Motor Deprecation
 
-   Motor will be deprecated one year after the production release of the {+driver-async+}
-   driver. We strongly recommend that Motor users migrate to the {+driver-async+} driver while
-   Motor is still supported.
+   The {+driver-async+} driver is experimental. We do **not** recommend using it
+   in production environments.
+
+   Motor will be deprecated one year after the **production release** of the
+   {+driver-async+} driver. We strongly recommend that Motor users migrate to
+   the {+driver-async+} driver while Motor is still supported.
 
 The {+driver-async+} driver functions similarly to the Motor library, but allows
 for improved latency and throughput due to directly using Python Asyncio instead