draft complete

Author: gitName

articles/api-management/import-api-from-oas.md

@@ -14,7 +14,7 @@ ms.custom: engagement-fy23, devx-track-azurepowershell, devx-track-azurecli
 
 [!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
 
-This article shows how to import an "OpenAPI specification" backend API to Azure API Management using a variety of tools. The article also shows how to test the API in API Management. 
+This article shows how to import an "OpenAPI specification" backend API to Azure API Management using various tools. The article also shows how to test the API in API Management. 
 
 In this article, you learn how to:
 > [!div class="checklist"]
@@ -37,7 +37,7 @@ In this article, you learn how to:
 
 ## <a name="create-api"> </a>Import a backend API
 
-For this example, you import the [specification](https://petstore3.swagger.io/api/v3/openapi.json) for the open source [Petstore API](https://petstore3.swagger.io/), but you can substitute an OpenAPI specification of your choice.
+For this example, you import the [OpenAPI specification](https://petstore3.swagger.io/api/v3/openapi.json) for the open source [Petstore API](https://petstore3.swagger.io/), but you can substitute an OpenAPI specification of your choice.
 
 
 #### [Portal](#tab/portal)
@@ -99,16 +99,29 @@ After importing the API, if needed, you can update the settings by using the [Se
 
 ---
 
-[!INCLUDE [api-management-test-api-portal](../../includes/api-management-test-api-portal.md)]
+## View and edit OpenAPI specification
 
-[!INCLUDE [api-management-append-apis.md](../../includes/api-management-append-apis.md)]
+In the portal, use the OpenAPI specification editor to view, validate, or edit the specification for the API that you imported. 
 
-[!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]
+TO use the OpenAPI specification editor:
+
+1. In the Azure portal, navigate to your API Management instance.
+1. In the left menu, under **APIs**, select **APIs** > **\<your API\>** > **All operations**.
+1. On the **Design** tab, in **Frontend**, select **OpenAPI Specification editor** (pencil icon). You can open the specification in JSON or YAML format.
+1. Review or edit the specification as needed. **Save** your changes.
 
 ## Validate against an OpenAPI specification schema
 
 You can configure API Management [validation policies](api-management-policies.md#content-validation) to validate requests and responses (or elements of them) against the schema in an OpenAPI specification. For example, use the [validate-content](validate-content-policy.md) policy to validate the size or content of a request or response body.
 
+
+[!INCLUDE [api-management-test-api-portal](../../includes/api-management-test-api-portal.md)]
+
+[!INCLUDE [api-management-append-apis.md](../../includes/api-management-append-apis.md)]
+
+[!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]
+
+
 ## Next steps
 
 > [!div class="nextstepaction"]

includes/api-management-append-apis.md

@@ -23,11 +23,11 @@ Append a different API to your existing API using the following steps.
 
 1. Go to your Azure API Management instance in the Azure portal.
 
-    :::image type="content" source="./media/api-management-append-apis/service-page-1.png" alt-text="Go to Azure API Mgmt instance":::
+    :::image type="content" source="./media/api-management-append-apis/service-page-1.png" alt-text="Screenshot of navigating to API Management instance in the portal.":::
 
 1. Select **APIs** on the **Overview** page or from the menu on the left.
 
-    :::image type="content" source="./media/api-management-append-apis/api-select-1.png" alt-text="Select APIs":::
+    :::image type="content" source="./media/api-management-append-apis/api-select-1.png" alt-text="Screenshot of selecting APIs on Overview page in the portal.":::
 
 1. Click **...** next to the API that you want to append another API to.
 1. Select **Import** from the drop-down menu.
@@ -36,4 +36,4 @@ Append a different API to your existing API using the following steps.
 
 1. Select a service from which to import an API.
 
-    :::image type="content" source="./media/api-management-append-apis/select-to-import.png" alt-text="Select service":::
+    :::image type="content" source="./media/api-management-append-apis/select-to-import.png" alt-text="Screenshot of selecting a service in the portal.":::