Merge pull request #279320 from v-sreedevank/26Jun-GH121343

GH 121343

Author: Jill Grant

articles/migrate/troubleshoot-project.md

@@ -4,8 +4,8 @@ description: Helps you to troubleshoot issues with creating and managing Azure M
 author: v-sreedevank
 ms.author: v-sreedevank
 ms.topic: troubleshooting
-ms.date: 02/18/2022
-ms.custom: engagement-fy23
+ms.date: 06/26/2024
+ms.custom: engagement-fy24
 ---
 
 # Troubleshoot Azure Migrate projects
@@ -14,16 +14,15 @@ This article helps you troubleshoot issues when creating and managing [Azure Mig
 
 ## How to add new project?
 
-You can have multiple Azure Migrate projects in a subscription. [Learn how](./create-manage-projects.md) to create a project for the first time, or [add additional](create-manage-projects.md#create-additional-projects) projects.
+You can have multiple Azure Migrate projects in a subscription. Learn how to [create a project](./create-manage-projects.md) for the first time, or [add additional](create-manage-projects.md#create-additional-projects) projects.
 
 ## What Azure permissions are needed?
 
 You need Contributor or Owner permissions in the subscription to create an Azure Migrate project.
 
 ## Can't find a project
 
-Finding an existing Azure Migrate project depends upon whether you're using the current or old version of Azure Migrate. [Follow](create-manage-projects.md#find-a-project).
-
+Finding an existing Azure Migrate project depends upon whether you're using the current or old version of Azure Migrate. [Follow these steps](create-manage-projects.md#find-a-project).
 
 ## Can't find a geography
 
@@ -41,22 +40,22 @@ Projects from the previous version of Azure Migrate can't be updated. You need t
 
 If you try to create a project and encounter a deployment error:
 
-- Try to create the project again in case it's a transient error. In **Deployments**, click on **Re-deploy** to try again.
+- Try to create the project again in case it's a transient error. In **Deployments**, select **Re-deploy** to try again.
 - Check you have Contributor or Owner permissions in the subscription.
 - If you're deploying in a newly added geography, wait a short time and try again.
 - If you receive the error, "Requests must contain user identity headers", this might indicate that you don't have access to the Microsoft Entra tenant of the organization. In this case:
-    - When you're added to a Microsoft Entra tenant for the first time, you receive an email invitation to join the tenant.
-    - Accept the invitation to be added to the tenant.
-    - If you can't see the email, contact a user with access to the tenant, and ask them to [resend the invitation](../active-directory/external-identities/add-users-administrator.md#resend-invitations-to-guest-users) to you.
-    - After receiving the invitation email, open it and select the link to accept the invitation. Then, sign out of the Azure portal and sign in again. (refreshing the browser won't work.) You can then start creating the migration project.
+  - When you're added to a Microsoft Entra tenant for the first time, you receive an email invitation to join the tenant.
+  - Accept the invitation to be added to the tenant.
+  - If you can't see the email, contact a user with access to the tenant, and ask them to [resend the invitation](../active-directory/external-identities/add-users-administrator.md#resend-invitations-to-guest-users) to you.
+  - After receiving the invitation email, open it and select the link to accept the invitation. Then, sign out of the Azure portal and sign in again. (refreshing the browser won't work.) You can then start creating the migration project.
 
 ## How do I delete a project
 
-[Follow these instructions](create-manage-projects.md#delete-a-project) to delete a project. Note that when you delete a project, both the project and the metadata about discovered machines in the project are deleted.
+[Follow these instructions](create-manage-projects.md#delete-a-project) to delete a project. When you delete a project, both the project and the metadata about discovered machines in the project are deleted.
 
 ## Added tools don't show
 
-Make sure you have the right project selected. In the Azure Migrate hub > **Servers** or in **Databases**, click on **Change** next to **Migrate project (Change)** in the top-right corner of the screen. Choose the correct subscription and project name > **OK**. The page should refresh with the added tools of the selected project.
+Make sure you have the right project selected. In the Azure Migrate hub, select **Servers, databases and web apps**. Select your project and subscription from the **Project** drop-down list. The page refreshes with the selected project and added tools.
 
 ## Next steps