DOCSP-49615-Relational-Migrator-1.13.1-release-notes (#251)

* DOCSP-49615-Relational-Migrator-1.13.1-release-notes

* Formatting, editorial tweaks, adding important notice.

* Edits from team review.

Author: mmaville-mdb

source/release-notes.txt

@@ -17,6 +17,64 @@ Download the latest {+rel-mig+} binary from the `release page <https://www.mongo
 For installation instructions, see the :ref:`Installation <installation>` 
 page. 
 
+1.13.1 Changelog
+----------------
+
+*Released April 29, 2025*
+
+Data Integrity Advisory:
+
+.. warning::
+
+   This release includes two critical fixes for data integrity issues affecting 
+   previous versions of Relational Migrator. The Relational Migrator team has 
+   also identified further data integrity issues that affect certain Snapshot 
+   and Continuous Migration configurations. These issues are scheduled to be 
+   addressed in an upcoming release. This 1.13.1 release temporarily disables 
+   Continuous Migrations (CDC mode) for projects which include any embedded 
+   document or array mappings. If Relational Migrator indicates that you may
+   be affected when running a new CDC job after upgrading, MongoDB recommends
+   holding off on performing Continuous Migration jobs in production or
+   manually verifying your migrated data for potential data loss until further 
+   updates are available.
+
+Critical Bug Fixes:
+
+- Fixed an issue where Snapshot Migrations could fail to populate deeply nested 
+  Embedded Arrays if the mappings are structured such that an Embedded Document 
+  mapping is between two Embedded Array mappings in the mapping hierarchy.
+- Fixed an issue with Continuous Migrations where relational tables with no 
+  primary key could cause duplicate entries in embedded arrays when the row 
+  is updated.
+ 
+
+Improvements:
+
+- Improved performance for snapshot migrations containing embedded arrays.
+- Faster initial database loads when connecting to large databases containing 
+  many tables.
+- Enhanced migration and verification errors with more details and debugging 
+  information. 
+- Improved error and warning reporting for pre-migration and post-migration 
+  tasks.
+- Imported and new projects now use a consistent naming scheme to generate 
+  their project ID.
+- Added support for Oracle JDBC Driver version 23.
+ 
+
+Bug Fixes:
+
+- Fixed an issue with idempotent-mode snapshot migrations where subsequent runs 
+  of the migration could cause duplicate entries in embedded arrays. This occurs 
+  with nested mappings where the embedded array contains additional embedded 
+  documents or arrays.
+- Fixed an issue where fields containing dot characters in their name cause 
+  errors during snapshot and continuous migrations.
+- Fixed issues where editing an embedded mapping field to add the prefix ``_id`` 
+  results in the unexpected UI behaviour.
+- Updated generated prerequisite configuration and permissions SQL script for 
+  Oracle to include AWS RDS instructions.
+
 1.13.0 Changelog
 ----------------