From 9df6cb57267d1f5687776724a2877a020c4157b7 Mon Sep 17 00:00:00 2001 From: Stephanie <52582720+stephmarie17@users.noreply.github.com> Date: Fri, 18 Apr 2025 10:23:53 -0700 Subject: [PATCH] DOCSP-493767 Update migration admonitions to clarify release phases (#261) (cherry picked from commit 79e43308a2f518147a357dd96e2b7c7d22546db6) --- source/includes/pymongo-async-experimental.rst | 10 +++++----- source/reference/migration.txt | 9 ++++++--- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/source/includes/pymongo-async-experimental.rst b/source/includes/pymongo-async-experimental.rst index 4d332cfe..5bd947c5 100644 --- a/source/includes/pymongo-async-experimental.rst +++ b/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. \ No newline at end of file + 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. \ No newline at end of file diff --git a/source/reference/migration.txt b/source/reference/migration.txt index 919739ef..b120ccbf 100644 --- a/source/reference/migration.txt +++ b/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