Add edits

Author: cdpark

articles/api-management/media/websocket-api/onhandshake-screen.png

@@ -17,9 +17,9 @@ ms.date: 03/16/2026
 
 [!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
 
-This article describes how to import an OData (Open Data Protocol) service by using its metadata description. The following example uses [SAP Gateway Foundation](https://help.sap.com/docs/SAP_GATEWAY).
+This article describes how to import an OData (Open Data Protocol) service into Azure API Management by using OData metadata. The following example uses [SAP Gateway Foundation](https://help.sap.com/docs/SAP_GATEWAY).
 
-In this article, you: 
+In this article, you learn how to: 
 > [!div class="checklist"]
 > * Retrieve OData metadata from your SAP service
 > * Import OData metadata to Azure API Management, either directly or after converting it to an OpenAPI specification

articles/api-management/media/websocket-api/query-gateway-logs.png

@@ -15,19 +15,19 @@ ms.custom:
 
 [!INCLUDE [api-management-availability-premium-dev-standard-basic-consumption](../../includes/api-management-availability-premium-dev-standard-basic-consumption.md)]
 
-In this tutorial, you learn how to use the API Management extension for Visual Studio Code for common operations in API Management. Use the familiar Visual Studio Code environment to import, update, test, and manage APIs.
+In this tutorial, you learn how to use the Azure API Management extension for Visual Studio Code for common operations in API Management. You can use the familiar Visual Studio Code environment to import, update, test, and manage APIs.
 
 [!INCLUDE [api-management-workspace-availability](../../includes/api-management-workspace-availability.md)]
 
-You learn how to:
+In this article, you learn how to: 
 
 > [!div class="checklist"]
 > * Import an API into API Management
 > * Edit the API
 > * Apply API Management policies
 > * Test the API
 
-:::image type="content" source="media/visual-studio-code-tutorial/tutorial-api-result.png" alt-text="Screenshot of API in API Management extension.":::
+:::image type="content" source="media/visual-studio-code-tutorial/tutorial-api-result.png" alt-text="Screenshot of API in API Management extension." lightbox="media/visual-studio-code-tutorial/tutorial-api-result.png":::
 
 For an introduction to more API Management features, see [Import and publish your first API](import-and-publish.md).
 
@@ -126,7 +126,7 @@ You need a subscription key for your API Management instance to test the importe
 
 1. Select **Send request**.
 
-:::image type="content" source="media/visual-studio-code-tutorial/test-api.png" alt-text="Screenshot of sending API request from Visual Studio Code.":::
+    :::image type="content" source="media/visual-studio-code-tutorial/test-api.png" alt-text="Screenshot of sending API request from Visual Studio Code.":::
 
 When the request succeeds, the backend responds with **200 OK** and some data.
 

articles/api-management/sap-api.md

@@ -15,11 +15,11 @@ ms.custom:
 
 [!INCLUDE [api-management-availability-premium-dev-standard-basic-premiumv2-standardv2-basicv2](../../includes/api-management-availability-premium-dev-standard-basic-premiumv2-standardv2-basicv2.md)]
 
-With API Management's WebSocket API solution, API publishers can quickly add a WebSocket API in API Management via the Azure portal, Azure CLI, Azure PowerShell, and other Azure tools. 
+With Azure API Management's WebSocket API solution, API publishers can quickly add a WebSocket API in API Management by using the Azure portal, Azure CLI, Azure PowerShell, and other Azure tools. 
 
-WebSocket APIs can be secured by applying API Management's [access control policies](api-management-policies.md#authentication-and-authorization) to the initial handshake operation. You can also test WebSocket APIs using the API test consoles in both Azure portal and developer portal. Building on existing observability capabilities, API Management provides metrics and logs for monitoring and troubleshooting WebSocket APIs. 
+WebSocket APIs can be secured by applying API Management's [access control policies](api-management-policies.md#authentication-and-authorization) to the initial handshake operation. You can also test WebSocket APIs by using the API test consoles in both Azure portal and developer portal. Building on existing observability capabilities, API Management provides metrics and logs for monitoring and troubleshooting WebSocket APIs. 
 
-In this article, you:
+In this article, you learn how to:
 > [!div class="checklist"]
 > * Understand WebSocket passthrough flow.
 > * Add a WebSocket API to your API Management instance.
@@ -61,7 +61,7 @@ Per the [WebSocket protocol](https://tools.ietf.org/html/rfc6455), when a client
 
 Each WebSocket API in API Management has an *onHandshake* operation. onHandshake is an immutable, unremovable, automatically created system operation. The onHandshake operation enables API publishers to intercept these handshake requests and apply API Management policies to them.
 
-:::image type="content" source="./media/websocket-api/onhandshake-screen.png" alt-text="Screenshot showing onHandshake screen example.":::
+:::image type="content" source="./media/websocket-api/onhandshake-screen.png" alt-text="Screenshot showing onHandshake screen example." lightbox="./media/websocket-api/onhandshake-screen.png":::
 
 ## Add a WebSocket API
 
@@ -116,7 +116,7 @@ Each WebSocket API in API Management has an *onHandshake* operation. onHandshake
 Use standard API Management and Azure Monitor features to [monitor](api-management-howto-use-azure-monitor.md) WebSocket APIs:
 
 * View API metrics in Azure Monitor
-* Optionally enable diagnostic settings to collect and view API Management gateway logs, which include WebSocket API operations, or WebSocket connection logs
+* Optionally, enable diagnostic settings to collect and view API Management gateway logs, which include WebSocket API operations, or WebSocket connection logs
 
 For example, the following screenshot shows recent WebSocket API responses with code `101` from the **ApiManagementGatewayLogs** table. These results indicate the successful switch of the requests from TCP to the WebSocket protocol.