Merge pull request SharePoint#9241 from JoanneHendrickson/patch-89

Update migration-api-whats-new.md

Author: andrewconnell

docs/apis/migration-api-whats-new.md

@@ -1,7 +1,7 @@
 ---
 title: "Migration API What's new"
 description: "Learn about the new features and updates to the Migration API."
-ms.date: 09/06/2023
+ms.date: 09/26/2023
 ms.reviewer: jhendr
 author: JoanneHendrickson
 ms.author: jhendr
@@ -16,6 +16,36 @@ ms.custom: admindeeplinkSPO
 
 Check here to see what features or updates have been added to the Migration API. Here's a summary of what's included.
 
+## Encoding invalid XML characters
+
+When invalid XML characters are detected in relevant fields, they're encoded. For any attribute that is XML encoded, decoding is needed for the value. Encoded fields are included in `EncodedAttributes`, in a comma-separated attribute list.
+
+**Example**
+
+In this  example, these attributes are encoded: URL, ParentWebURL, Name, and Version.
+
+```xml
+<File Url="testlib_x002F_File_0905-1653-31240"
+      Id="e72e2015-91a4-4d07-ae9a-7b6c76918d2a"
+      ParentWebId="7206fc09-e4af-48b3-8730-ed7321396d7a"
+      ParentWebUrl="_x002F_"
+      Name="File_0905-1653-31240"
+      ListItemIntId="3"
+      ListId="48ea9454-9538-47ae-926d-917df80bc93e"
+      ParentId="33ff2f12-c818-4c8d-8578-c6d057172fd8"
+      ScopeId="385cd4d5-86da-4183-bdac-2e83da1b05fc"
+      TimeCreated="2021-11-08T03:57:05"
+      TimeLastModified="2021-01-17T16:01:48"
+      Version="_x0031_.0"
+      FileSize="1"
+      Level="1"
+      EncodedAttributes="Url,ParentWebUrl,Name,Version">
+```
+
+>[!Warning]
+>If XSD is replied on to parse manifest files, parsing may fail when **EncodedAttributes** is used.
+
+
 ## Updated reason code and descriptions
 
 We have updated Migration API to provide detailed reasons in case a job is postponed. We encourage ISVs take appropriate actions, based on the reasons.