Merge pull request #297790 from MicrosoftDocs/main

Merged by Learn.Build PR Management system

Author: learn-build-service-prod[bot]

articles/active-directory-b2c/tutorial-create-user-flows.md

@@ -58,7 +58,7 @@ The sign-up and sign-in user flow handles both experiences with a single configu
 1. Sign in to the [Azure portal](https://portal.azure.com).
 1. If you have access to multiple tenants, select the **Settings** icon in the top menu to switch to your Azure AD B2C tenant from the **Directories + subscriptions** menu.
 1. In the Azure portal, search for and select **Azure AD B2C**.
-1. Under **Policies**, select **User flows**, and then select **New user flow**.
+1. <a name="new_user_flow"></a>Under **Policies**, select **User flows**, and then select **New user flow**.
 
     ![Screenshot of the User flows page from the Azure portal with New user flow button highlighted.](./media/tutorial-create-user-flows/sign-up-sign-in-user-flow.png)
 

articles/api-center/enable-api-center-portal-vs-code-extension.md

@@ -46,7 +46,6 @@ Enterprise developers must sign in with a Microsoft account to see the API Cente
 
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
-### For API center administrators
 ## Steps for enterprise developers to access the API Center portal 
 
 Developers can follow these steps to connect and sign in to view an API Center portal using the Visual Studio Code extension. Settings to connect to the API center need to be provided by the API center administrator.

articles/api-center/includes/api-center-portal-app-registration.md

@@ -11,8 +11,6 @@ ms.author: danlep
 ms.custom: Include file
 ---
 
-## Create Microsoft Entra app registration
-
 First configure an app registration in your Microsoft Entra ID tenant. The app registration enables the API Center portal to access data from your API center on behalf of a signed-in user.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to **Microsoft Entra ID** > **App registrations**.
@@ -24,5 +22,13 @@ First configure an app registration in your Microsoft Entra ID tenant. The app r
     1. In **Redirect URI**, select **Single-page application (SPA)** and set the URI. 
         Enter the URI of your API Center portal deployment, in the following form: `https://<service-name>.portal.<location>.azure-api-center.ms`. Replace `<service name>` and `<location>` with the name of your API center and the location where it's deployed, Example: `https://myapicenter.portal.eastus.azure-api-center.ms`.
     1. Select **Register**.
-    1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**. 
-    1. Configure the following three custom redirect URIs: `https://vscode.dev/redirect`, `http://localhost`, and `ms-appx-web://Microsoft.AAD.BrokerPlugin/<application-client-id>`. Replace `<application-client-id>` with the application (client) ID of this app. You can find this value on the **Overview** page. 
+
+When enabling the API Center portal in the Visual Studio Code extension for API Center, also configure the following redirect URIs. 
+
+1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**. 
+1. Configure the following three custom redirect URIs:<br/>
+    `https://vscode.dev/redirect`<br/>
+    `http://localhost`<br/>
+    `ms-appx-web://Microsoft.AAD.BrokerPlugin/<application-client-id>`<br/>
+    
+    Replace `<application-client-id>` with the application (client) ID of this app. You can find this value on the **Overview** page. 

articles/api-center/includes/api-center-portal-user-sign-in.md

@@ -11,9 +11,7 @@ ms.author: danlep
 ms.custom: Include file
 ---
 
-## Enable sign-in to portal by Microsoft Entra users and groups 
-
-Users must sign in to see the APIs in your API center. To enable sign-in, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
+To enable sign-in, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
 
 > [!IMPORTANT]
 > By default, you and other administrators of the API center don't have access to APIs in the API Center portal. Be sure to assign the **Azure API Center Data Reader** role to yourself and other administrators.  

articles/api-center/self-host-api-center-portal.md

@@ -39,6 +39,8 @@ The API Center portal reference implementation provides:
     * [Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
     * [Vite package](https://www.npmjs.com/package/vite)
 
+## Create Microsoft Entra app registration
+
 [!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
 
 > [!NOTE]
@@ -100,6 +102,9 @@ Follow these steps to build and test the API Center portal locally.
 
 For steps to deploy the portal to Azure Static Web Apps, see the [API Center portal starter](https://github.com/Azure/APICenter-Portal-Starter.git) repository.
 
+## Enable sign-in to portal by Microsoft Entra users and groups 
+
+
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
 ## Troubleshooting

articles/api-center/set-up-api-center-portal.md

@@ -22,8 +22,11 @@ This article shows you how to set up the *API Center portal* (preview), an Azure
 > [!TIP]
 > Both Azure API Management and Azure API Center provide API portal experiences for developers. [Compare the portals](#api-management-and-api-center-portals)
 
+
 [!INCLUDE [api-center-portal-prerequisites](includes/api-center-portal-prerequisites.md)]
 
+## Create Microsoft Entra app registration
+
 [!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
 
 ## Configure and publish the API Center portal
@@ -53,6 +56,8 @@ To make only specific APIs visible, go to the **API visibility** tab in the API
 
 :::image type="content" source="media/set-up-api-center-portal/add-visibility-condition.png" alt-text="Screenshot of adding API visibility conditions in the portal.":::
 
+## Enable sign-in to portal by Microsoft Entra users and groups 
+
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
 [!INCLUDE [api-center-portal-compare-apim-dev-portal](includes/api-center-portal-compare-apim-dev-portal.md)]

articles/api-management/TOC.yml

@@ -217,7 +217,7 @@
       href: grpc-api.md
     - name: Azure OpenAI and LLM APIs
       items:
-      - name: GenAI gateway capabilities in API Management
+      - name: AI gateway capabilities in API Management
         href: genai-gateway-capabilities.md
       - name: Import Azure OpenAI API
         href: azure-openai-api-from-specification.md

articles/api-management/api-management-gateways-overview.md

@@ -201,4 +201,4 @@ Lear more about:
 -   [API Management in a Hybrid and multicloud World](https://aka.ms/hybrid-and-multi-cloud-api-management)
 -   [Capacity metric](api-management-capacity.md) for scaling decisions
 -   [Observability capabilities](observability.md) in API Management
--   [GenAI gateway capabilities](genai-gateway-capabilities.md) in API Management
+-   [AI gateway capabilities](genai-gateway-capabilities.md) in API Management

articles/api-management/api-management-key-concepts.md

@@ -146,7 +146,7 @@ API Management integrates with many complementary Azure services to create enter
 **More information**:
 * [Basic enterprise integration](/azure/architecture/reference-architectures/enterprise-integration/basic-enterprise-integration?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json)
 * [Landing zone accelerator](/azure/cloud-adoption-framework/scenarios/app-platform/api-management/landing-zone-accelerator?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json)
-* [GenAI gateway capabilities in API Management](genai-gateway-capabilities.md)
+* [AI gateway capabilities in API Management](genai-gateway-capabilities.md)
 * [Synchronize APIs to API Center from API Management](../api-center/synchronize-api-management-apis.md?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json)
 
 ## Key concepts

articles/api-management/azure-openai-enable-semantic-caching.md

@@ -156,4 +156,4 @@ For example, if the cache was used, the **Output** section includes entries simi
 
 * [Caching policies](api-management-policies.md#caching)
 * [Azure Cache for Redis](../azure-cache-for-redis/cache-overview.md)
-* [GenAI gateway capabilities](genai-gateway-capabilities.md) in Azure API Management
+* [AI gateway capabilities](genai-gateway-capabilities.md) in Azure API Management