Merge pull request SharePoint#9663 from underreview/rr-jan2024-clean

Correcting errors and updating TOC

Author: andrewconnell

docs/apis/amr-api-reference.md

@@ -171,7 +171,7 @@ A `EncryptionOption` object, containing the AES-256-CBC Key used to decrypt the
 
 By default, AMR API doesn't encrypt the output and event queue. If set with AES-256-CBC Key, AMR API encrypts the output with the key supplied.
 
-See `[EncryptionOption](/dotnet/api/microsoft.sharepoint.client.encryptionoption)` class for details.
+See [`EncryptionOption`](/dotnet/api/microsoft.sharepoint.client.encryptionoption) class for details.
 
 #### azureContainerManifestUri
 

docs/apis/migration-api-overview.md

@@ -1,7 +1,7 @@
 ---
 title: "SharePoint Import Migration API"
-description: "This article provides in-depth information on how to use the SPO Migration API."
-ms.date: 04/18/2024
+description: "This article provides overview information on how to use the SharePoint Migration API."
+ms.date: 04/28/2024
 ms.author: ranren
 author: underreview
 manager: dapodean
@@ -51,8 +51,6 @@ Check [Manifest files](migration-manifest.md) to see the detailed requirements.
 
 ### Use Migration API to start the migration and get status
 
-Use `ProvisionMigrationContainers` method to provision the containers, upload the content package, and manifest into respective containers. Check [Use Azure Blob Storage Containers and Azure Queues with Migration API](migration-azure.md) for details. You can also use your own containers and queues if needed.
-
 `CreateMigrationJob` method creates a migration job, which is queued up for processing. Migration API manages the queue and returns status and logs. Use `CreateMigrationEncrypted` method to migrate encrypted contents. Check [SharePoint Migration API Reference](migration-api-reference.md) for details.
 
 Upon creation of a new migration job, Migration API returns the Job ID. Track the status of the import with `GetMigrationJobStatus` method if needed, with the Azure Queue supplied.

docs/apis/migration-api-reference.md

@@ -1,7 +1,7 @@
 ---
 title: "SharePoint Migration API Reference Guide"
 description: "This article provides in-depth information on how to use the SharePoint Migration API."
-ms.date: 04/18/2024
+ms.date: 04/28/2024
 ms.author: ranren
 author: underreview
 manager: dapodean
@@ -20,9 +20,7 @@ This guide describes the usage of SharePoint Migration API, which imports conten
 
 ## CSOM and REST
 
-AMR API supports both SharePoint Client Side Object Model (CSOM) and REST.
-
-CSOM consumes more resources than REST. Use REST whenever possible for best performance. Reduce resource consumption and ensure that your migration jobs run efficiently with REST.
+Migration API supports both SharePoint Client Side Object Model (CSOM) and REST.
 
 ### Use NuGet Packages with CSOM
 

docs/toc.yml

@@ -2245,37 +2245,40 @@
     href: apis/spod-copy-move-api.md
   - name: SharePoint Migration Guidance
     items:
-    - name: What's new in the Migration API
-      href: apis/migration-api-whats-new.md
     - name: Migration Guidance for ISVs
       href: apis/migration-isv-guidance.md
-    - name: Migration permission guidance
-      href: apis/migration-perm-guidance.md
-    - name: Migrating OneNote folders
-      href: apis/onenote-migration-service.md
-    - name: Sensitivity Labels and the SharePoint Migration API
-      href: apis/sp-migration-api-and-sensitivity-labels.md
-    - name: How to export video transcripts using the SharePoint Migration API
-      href: apis/migration-api-video-transcripts.md
-    - name: Migration API
+    - name: Content-Specific Migration Guidance
       items:
-      - name: Import Migration API
-        items:
-        - name: Import Migration API (CreateMigrationJob)
+      - name: OneNote Folders
+        href: apis/onenote-migration-service.md
+      - name: Sensitivity Labels
+        href: apis/sp-migration-api-and-sensitivity-labels.md
+      - name: Video Transcripts
+        href: apis/migration-api-video-transcripts.md
+      - name: Sharing
+        href: apis/migration-api-shared.md
+      - name: Web Parts
+        href: apis/migrate-webparts-with-migrationapi.md
+    - name: SharePoint Migration API
+      items:
+        - name: SharePoint Migration API Overview
           href: apis/migration-api-overview.md
-          items:
-          - name: Sharing
-            href: apis/migration-api-shared.md
-          - name: Migrate web parts using the Migration API
-            href: apis/migrate-webparts-with-migrationapi.md
-      - name: Export Migration API (Asynchronous Metadata Read)
+        - name: SharePoint Migration API Reference
+          href: apis/migration-api-reference.md
+    - name: Asynchronous Metadata Read (AMR) API
+      items:
+      - name: SharePoint Asynchronous Metadata Read (AMR) API Overview
         href: apis/export-amr-api.md
-      - name: Permissions guide for Export Migration API (Asynchronous Metadata Read)
-        href: apis/export-amr-api-permission-guide.md
-      - name: Azure container and queue
-        href: apis/migration-api-azure-container-and-queue.md
-      - name: Encryption
-        href: apis/migration-api-encryption.md
+      - name: SharePoint Asynchronous Metadata Read (AMR) API Reference
+        href: apis/amr-api-reference.md
+    - name: Azure container and queue
+      href: apis/migration-azure.md
+    - name: Migration Content Package
+      href: apis/migration-content-package.md
+    - name: Manifest Files
+      href: apis/migration-manifest.md
+    - name: Events
+      href: apis/migration-events.md
   - name: Microsoft Syntex REST API
     items:
       - name: Overview