edits

Author: v-albemi

articles/api-management/restify-soap-api.md

@@ -1,6 +1,6 @@
 ---
-title: Import SOAP API to Azure API Management and convert to REST using the portal | Microsoft Docs
-description: Learn how to import a SOAP API to Azure API Management as a WSDL specification and convert it to a REST API. Then, test the API in the Azure portal.
+title: Import a SOAP API to Azure API Management and convert it to REST using the portal | Microsoft Docs
+description: Learn how to import a SOAP API to Azure API Management as a WSDL specification and convert it to a REST API. Then test the API in the Azure portal.
 services: api-management
 author: dlepow
 ms.custom: devdivchpfy22
@@ -9,30 +9,32 @@ ms.topic: how-to
 ms.date: 03/27/2025
 ms.author: danlep
 
+#customer intent: As a developer, I want to import a SOAP API to API Management and convert it to REST.
+
 ---
-# Import SOAP API to API Management and convert to REST
+# Import a SOAP API to API Management and convert it to REST
 
 [!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
 
-This article shows how to import a SOAP API as a WSDL specification and then convert it to a REST API. The article also shows how to test the API in API Management.
+This article shows how to import a SOAP API as a WSDL specification and then convert it to a REST API. It also shows how to test the API in Azure API Management.
 
 In this article, you learn how to:
 
 > [!div class="checklist"]
-> * Import a SOAP API and convert to REST
+> * Import a SOAP API and convert it to REST
 > * Test the API in the Azure portal
 
 [!INCLUDE [api-management-wsdl-import](../../includes/api-management-wsdl-import.md)]
 
 ## Prerequisites
 
-Complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md)
+- Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
 
 [!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-navigate-to-instance.md)]
 
 ## <a name="create-api"> </a>Import and publish a back-end API
 
-1. From the left menu, under the **APIs** section, select **APIs** > **+ Add API**.
+1. In the left pane, in the **APIs** section, select **APIs** > **+ Add API**.
 1. Under **Create from definition**, select **WSDL**.
 
     ![SOAP API](./media/restify-soap-api/wsdl-api.png)

includes/api-management-navigate-to-instance.md

@@ -2,15 +2,15 @@
 author: dlepow
 ms.service: azure-api-management
 ms.topic: include
-ms.date: 04/16/2021
+ms.date: 03/27/2025
 ms.author: danlep
 ---
 ## Go to your API Management instance
 
 1. In the Azure [portal](https://portal.azure.com), search for and select **API Management services**.
 
-    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-1.png" alt-text="Select API Management services":::
+    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-1.png" alt-text="Screenshot that shows API Management services in the search results." lightbox="media/api-management-navigate-to-instance/view-apim-1.png":::
 
 1. On the **API Management services** page, select your API Management instance.
 
-    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-new.png" alt-text="Select your API Management instance":::
+    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-new.png" alt-text="Screenshot that shows an API Management instance on the API Management services page." lightbox="media/api-management-navigate-to-instance/view-apim-new.png":::