first draft

Author: jeff-allen-mongo

source/release-notes/1.13.txt

@@ -1,7 +1,7 @@
 .. _c2c-release-notes-1.13:
 
 ================================
-Release Notes for mongosync 1.12
+Release Notes for mongosync 1.13
 ================================
 
 .. contents:: On this page
@@ -20,42 +20,49 @@ This page describes changes and new features introduced in
 
 **March 25, 2025**
 
-MongoDB 8.0 support
-~~~~~~~~~~~~~~~~~~~
+New Features
+~~~~~~~~~~~~
 
-{+c2c-full-product-name+} 1.12 adds support for MongoDB 8.0 on the source 
-cluster. However, it does not migrate Persistent Query Settings (PQS), which 
-are new in 8.0. If your source cluster uses PQS, you must :ref:`migrate them 
-manually <c2c-migrate-pqs>`.
+- ``mongosync`` no longer requires you to fully disable the source
+  cluster's balancer for migrations started with namespace filtering.
+  Now, you only have to disable the balancer for collections within the
+  namespace filter.
+  
+  You can leave the balancer enabled for collections outside the filter.
+  The destination balancer still must be fully disabled for the duration
+  of the migration.
+  
+  .. note::
 
-For a full list of supported versions, see :ref:`c2c-server-version-compatibility`.
+     You don't need to disable the source balancer on a per-collection basis. You can
+     still disable the source balancer globally.
 
+Platform Support
+~~~~~~~~~~~~~~~~
 
-``enableUserWriteBlocking`` parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``mongosync`` builds are now available for the following platforms:
 
-The ``enableUserWriteBlocking`` parameter in the 
-:ref:`/start <c2c-api-start>` API now accepts the following string options:
-
-- ``"sourceAndDestination"`` for dual write-blocking
-- ``"none"`` for no write-blocking
-
-Use these options instead of the old ``true`` and ``false`` values.
-``enableUserWriteBlocking`` still supports ``true`` and ``false``
-for backward compatibility.
-
-See :ref:`c2c-api-start-params`.
+- Ubuntu 22.04 and 24.04
+- Amazon Linux 2023
 
 Live Upgrades
 ~~~~~~~~~~~~~
 
-:ref:`Live upgrades <c2c-live-upgrade>` 
-to version 1.12 are not supported.
+:ref:`Live upgrades <c2c-live-upgrade>` from version 1.12 to 1.13 are
+supported.
 
 Other Notes 
 ~~~~~~~~~~~
 
-- Added a machine-friendly label to warnings about Persisted Query Settings
+Fixed Issues:
+
+- Fixed a bug introduced in v1.0.0 where ``mongosync`` could exit
+  gracefully (instead of crashing with a fatal level log) on some
+  errors.
+
+- Fixed a bug introduced in v1.11.0 where ``mongosync`` returned a
+  confusing error when the user lacked sufficient permissions to enable
+  destination-only write blocking by default.
 
 Minimum Supported Version
 -------------------------