edits

v-albemi · v-albemi · commit c06b5303fdb3 · 2025-03-20T10:45:44.000-07:00
diff --git a/articles/api-management/mock-api-responses.md b/articles/api-management/mock-api-responses.md
@@ -44,59 +44,59 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-+ Learn the [Azure API Management terminology](api-management-terminology.md).
-+ Understand the [concept of policies in Azure API Management](api-management-howto-policies.md).
-+ Complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md).
++ Learn [API Management terminology](api-management-terminology.md).
++ Understand the [concept of policies in API Management](api-management-howto-policies.md).
++ Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
 
 ## Create a test API
 
-The steps in this section show how to create an HTTP API with no backend.
+The steps in this section show how to create an HTTP API with no back end.
 
 1. Sign in to the Azure portal, and then navigate to your API Management instance.
-1. Select **APIs** > **+ Add API** > **HTTP** tile.
+1. Select **APIs** > **+ Add API** > **HTTP** tile:
 
-   :::image type="content" source="media/mock-api-responses/http-api.png" alt-text="Define a HTTP API":::
+   :::image type="content" source="media/mock-api-responses/http-api.png" alt-text="Screenshot that shows the first steps for defining an API." lightbox="media/mock-api-responses/http-api.png":::
 
 1. In the **Create an HTTP API** window, select **Full**.
-1. Enter *Test API* for **Display name**.
-1. Select **Unlimited** for **Products**.
-1. Ensure that **Managed** is selected for **Gateways**.
+1. In **Display name**, enter *Test API*.
+1. In **Products**, select **Unlimited**.
+1. Ensure that **Managed** is selected in **Gateways**.
 1. Select **Create**.
 
-    :::image type="content" source="media/mock-api-responses/create-http-api.png" alt-text="Create an HTTP API":::
+    :::image type="content" source="media/mock-api-responses/create-http-api.png" alt-text="Screenshot that shows the Create an HTTP API window.":::
 
 ## Add an operation to the test API
 
-An API exposes one or more operations. In this section, you'll add an operation to the HTTP API you created. Calling the operation after completing the steps in this section triggers an error. After you complete the steps in the [Enable response mocking](#enable-response-mocking) section, you'll get no errors.
+An API exposes one or more operations. In this section, you add an operation to the HTTP API you created. Calling the operation after completing the steps in this section triggers an error. After you complete the steps in the [Enable response mocking](#enable-response-mocking) section, you won't get an error.
 
 ### [Portal](#tab/azure-portal)
 
-1. Select the API you created in the previous step.
+1. Select the API that you created in the previous step.
 1. Select **+ Add Operation**.
-1. In the **Frontend** window, enter the following values.
+1. In the **Frontend** window, enter the following values:
 
-   :::image type="content" source="media/mock-api-responses/frontend-window.png" alt-text="Frontend window":::
+     | Setting             | Value         | Description   |
+    |------|------|-----------------------------------------|
+    | **Display name**    | *Test call*  | The name that's displayed in the [developer portal](api-management-howto-developer-portal.md).    |
+    | **URL** (HTTP verb) | GET | Select one of the predefined HTTP verbs.    |
+    | **URL**  | */test*   | A URL path for the API.            |
+    | **Description** |   |  An optional description of the operation. It provides documentation in the developer portal to the developers who use the API.                         |
 
-     | Setting             | Value                             | Description                                                                                                                                                                                   |
-    |---------------------|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-    | **Display name**    | *Test call*                       | The name that is displayed in the [developer portal](api-management-howto-developer-portal.md).                                                                                                                                       |
-    | **URL** (HTTP verb) | GET                               | Select one of the predefined HTTP verbs.                                                                                                                                         |
-    | **URL**             | */test*                           | A URL path for the API.                                                                                                                                                                       |
-    | **Description**     |                                   |  Optional description of the operation, used to provide documentation in the developer portal to the developers using this API.                                                    |
+    :::image type="content" source="media/mock-api-responses/frontend-window.png" alt-text="Screenshot that shows the Frontend window." lightbox="media/mock-api-responses/frontend-window.png":::
 
-1. Select the **Responses** tab, located under the URL, Display name, and Description fields. Enter settings on this tab to define response status codes, content types, examples, and schemas.
-1. Select **+ Add response**, and select **200 OK** from the list.
+1. Select the **Responses** tab, which  is located under the **URL**, **Display name**, and **Description** boxes. Enter values on this tab to define response status codes, content types, examples, and schemas.
+1. Select **+ Add response**, and then select **200 OK** from the list.
 
-    :::image type="content" source="media/mock-api-responses/add-response.png" alt-text="Add response to the API operation":::
+    :::image type="content" source="media/mock-api-responses/add-response.png" alt-text="Screenshot that shows the Responses tab." lightbox="media/mock-api-responses/add-response.png":::
 
-1. Under the **Representations** heading on the right, select **+ Add representation**.
-1. Enter *application/json* into the search box and select the **application/json** content type.
-1. In the **Sample** text box, enter  `{ "sampleField" : "test" }`.
+1. In the **Representations** section, select **+ Add representation**.
+1. Enter *application/json* into the search box and then select the **application/json** content type.
+1. In the **Sample** box, enter  `{ "sampleField" : "test" }`.
 1. Select **Save**.
 
-    :::image type="content" source="media/mock-api-responses/add-representation.png" alt-text="Add representation to the API operation":::
+    :::image type="content" source="media/mock-api-responses/add-representation.png" alt-text="Screenshot that shows the Representations section." lightbox="media/mock-api-responses/add-representation.png":::
 
-Although not required for this example, you can configure more settings for an API operation on other tabs, including:
+Although it's not required for this example, you can configure more settings for an API operation on other tabs, as described in the following table:
 
 |Tab      |Description  |
 |---------|---------|
