wip

Author: gitName

articles/api-center/TOC.yml

@@ -38,7 +38,7 @@
         href: manage-apis-azure-cli.md
       - name: Import APIs from API Management
         href: import-api-management-apis.md
-      - name: Register APIs - VS Code extension
+      - name: Build and register APIs - VS Code extension
         href: use-vscode-extension.md
       - name: Register APIs - GitHub Actions
         href: register-apis-github-actions.md
@@ -56,7 +56,7 @@
         href: find-nonproduction-api-requests-dev-proxy.md
 - name: API discovery and consumption
   items:
-      - name: Discover APIs in data view - VS Code extension
+      - name: Enable platform API catalog - VS Code extension
         href: enable-data-view-vscode-extension.md
       - name: Self-host Azure API Center portal
         href: enable-api-center-portal.md

articles/api-center/enable-data-view-vscode-extension.md renamed to articles/api-center/enable-platform-api-catalog-vscode-extension.md

@@ -1,18 +1,18 @@
 ---
-title: Enable Azure API Center data view - Visual Studio Code extension
-description: Enable developers to view API data including API definitions using the Visual Studio Code Extension for Azure API Center.
+title: Enable platform API catalog - Azure API Center - VS Code extension
+description: Enable enterprise developers to view the enterprise's platform API catalog including API definitions using the Visual Studio Code Extension for Azure API Center.
 author: dlepow
 ms.service: azure-api-center
 ms.topic: how-to
-ms.date: 09/10/2024
+ms.date: 09/23/2024
 ms.author: danlep 
 ms.custom: 
-# Customer intent: As an API program manager, I want to enable an extension in Visual Studio Code so that developers in my organization to discover the APIs in my organization's API center without access to Azure to manage the API center.
+# Customer intent: As an API program manager, I want to enable an API catalog so that app developers in my organization can discover and consume the APIs in my organization's API center without needing to manage the API inventory itself.
 ---
 
-# Enable access to Azure API Center data - Visual Studio Code extension
+# Enable access to Azure API Center platform API catalog 
 
-This article shows how to enable access to the API Center data view (preview) in the Visual Studio Code extension for [Azure API Center](overview.md). Using the data view, developers can discover APIs in your Azure API center, view API definitions, and optionally generate API clients when they don't have access to manage the API center itself. Access to the data view is managed using Microsoft Entra ID and Azure role-based access control.
+This article shows how to provide enterprise developers access to the Azure API Center platform API catalog (preview) in the Visual Studio Code extension for [Azure API Center](overview.md). Using the platform API catalog, developers can discover APIs in your Azure API center, view API definitions, and optionally generate API clients when they don't have access to manage the API center itself or add APIs to the inventory. Access to the platform API catalog is managed using Microsoft Entra ID and Azure role-based access control.
 
 ## Prerequisites
 
@@ -22,28 +22,28 @@ This article shows how to enable access to the API Center data view (preview) in
 
 * [Azure API Center extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=apidev.azure-api-center)
 
-    > [!NOTE]
-    > Currently, access to the API Center data view is available only in the extension's pre-release version. When installing the extension from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=apidev.azure-api-center&ssr=false#overview), you can choose to install the release version or a pre-release version. Switch between the two versions at any time by using the extension's **Manage** button context menu in the Extensions view. 
-
+    > [!IMPORTANT]
+    > Currently, access to the platform API catalog is available only in the extension's pre-release version. [!INCLUDE [vscode-extension-prerelease-features](includes/vscode-extension-prerelease-features.md)]
+    
 The following Visual Studio Code extension is optional:
 
 * [Microsoft Kiota extension](https://marketplace.visualstudio.com/items?itemName=ms-graph.kiota) - to generate API clients
 
 ## Create Microsoft Entra app registration
 
-First, configure an app registration in your Microsoft Entra ID tenant. The app registration enables the Visual Studio Code extension for Azure API Center to access data from your API center on behalf of a signed-in user.
+First, configure an app registration in your Microsoft Entra ID tenant. The app registration enables the Visual Studio Code extension for Azure API Center to access the platform API catalog on behalf of a signed-in user.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to **Microsoft Entra ID** > **App registrations**.
 1. Select **+ New registration**. 
 1. On the **Register an application** page, set the values as follows:
 
-    * Set **Name** to a meaningful name such as *api-center-data*
+    * Set **Name** to a meaningful name such as *platform-api-catalog*
     * Under **Supported account types**, select **Accounts in this organizational directory (Single tenant)**. 
-    * In **Redirect URI**, select **Single-page application (SPA)** and set the URI to the runtime URI of your API center. For example, `https://<service name>.data.<region>.azure-apicenter.ms`.
+    * In **Redirect URI**, select **Single-page application (SPA)** and set the URI to the runtime URI of your API center. For example, `https://<service name>.data.<region>.azure-apicenter.ms`. Example: `https://contoso-apic.data.eastus.azure-apicenter.ms`.
     * Select **Register**.
 
     > [!TIP]
-    > You can use the same app registration for access to more API centers. In **Redirect URI**, continue to add redirect URIs for other API centers that you want to appear in the data view.
+    > You can use the same app registration for access to more API centers. In **Redirect URI**, continue to add redirect URIs for other API centers that you want to appear in the platform API catalog.
 1. On the **Overview** page, copy the **Application (client) ID** and the **Directory (tenant) ID**. You set these values later when you connect to the API center from the Visual Studio Code extension. 
 1. In the left menu, under **Manage**, select **Authentication** > **+ Add a platform**.
 1. On the **Configure platforms** page, select **Mobile and desktop applications**.
@@ -60,14 +60,14 @@ First, configure an app registration in your Microsoft Entra ID tenant. The app
 
     The Azure API Center permissions appear under **Configured permissions**.
 
-    :::image type="content" source="media/enable-data-view-vscode-extension/configure-app-permissions.png" alt-text="Screenshot of required permissions in Microsoft Entra ID app registration in the portal." :::
+    :::image type="content" source="media/enable-platform-api-catalog-vscode-extension/configure-app-permissions.png" alt-text="Screenshot of required permissions in Microsoft Entra ID app registration in the portal." :::
 
-## Enable sign-in to data view by Microsoft Entra users and groups 
+## Enable sign-in to platform API catalog by Microsoft Entra users and groups 
 
-Users must sign in to see the data view for 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.
+Developers in the enterprise must sign in to see the platform API catalog for 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 extension's data view. Be sure to assign the **Azure API Center Data Reader** role to yourself and other administrators.  
+> By default, you and other administrators of the API center don't have access to APIs in the API Center extension's platform API catalog. Be sure to assign the **Azure API Center Data Reader** role to yourself and other administrators.  
 
 For detailed prerequisites and steps to assign a role to users and groups, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml). Brief steps follow:
 
@@ -78,40 +78,45 @@ For detailed prerequisites and steps to assign a role to users and groups, see [
     * On the **Members** page, In **Assign access to**, select **User, group, or service principal** > **+ Select members**.
     * On the **Select members** page, search for and select the users or groups to assign the role to. Click **Select** and then **Next**.
     * Review the role assignment, and select **Review + assign**.
-1. Repeat the preceding steps to enable sign-in to the data view for more API centers.
+1. Repeat the preceding steps to enable sign-in to the platform API catalog for more API centers.
 
 > [!NOTE]
 > To streamline access configuration for new users, we recommend that you assign the role to a Microsoft Entra group and configure a dynamic group membership rule. To learn more, see [Create or update a dynamic group in Microsoft Entra ID](/entra/identity/users/groups-create-rule).
 
-## Connect to an API center 
+## Steps for developers to connect to an API center 
+
+Developers in the enterprise can follow these steps to connect and sign in to an API center from the Visual Studio code extension.
 
-Developers can follow these steps to connect to an API center from the Visual Studio code extension and sign in to view the APIs.
+1. Install the pre-release version of the [Azure API Center extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=apidev.azure-api-center) for Visual Studio Code. 
 
 1. In Visual Studio Code, in the Activity Bar on the left, select API Center.
+    :::image type="content" source="media/enable-platform-api-catalog-vscode-extension/api-center-activity-bar.png" alt-text="Screenshot of the API Center icon in the Activity Bar.":::
+
 1. Use the **Ctrl+Shift+P** keyboard shortcut to open the Command Palette. Type **Azure API Center: Connect to an API Center** and hit **Enter**.
 1. Answer the prompts to input the following information:
-    1. The runtime URL of your API center. Example: `<service name>.data.<region>.azure-apicenter.ms`
+    1. The runtime URL of your API center, in the format `<service name>.data.<region>.azure-apicenter.ms` (don't prefix with `https://`). Example: `contoso-apic.data.eastus.azure-apicenter.ms`.
     1. The application (client) ID from the app registration configured in the previous section.
     1. The directory (tenant) ID from the app registration configured in the previous section.
 
     > [!TIP]
-    > An API center administrator needs to provide the connection settings to developers, or provide a direct link for developers to access an API center's data view. The link is in the following format:  
+    > An API center administrator needs to provide these connection settings to developers, or provide a direct link in the following format:  
     > `vscode://apidev.azure-api-center?clientId=<Client ID>&tenantId=<tenant ID>&runtimeUrl=<service-name>.data.<region>.azure-apicenter.ms`
 
-    After you connect to the API center, the API center appears in the API Center data view. 
+    After you connect to the API center, the API center appears in the API Center platform API catalog. 
 
-1. To view the APIs in the API center, select **Sign in to Azure**. Sign in with a Microsoft account that is assigned the **Azure API Center Data Reader** role in the API center. 
+1. To view the APIs in the API center, under the API center name, select **Sign in to Azure**. Sign-in is allowed with a Microsoft account that is assigned the **Azure API Center Data Reader** role in the API center. 
 
-    :::image type="content" source="media/enable-data-view-vscode-extension/api-center-pane-initial.png" alt-text="Screenshot of API Center Data View in VS Code extension." :::
+    :::image type="content" source="media/enable-platform-api-catalog-vscode-extension/api-center-pane-initial.png" alt-text="Screenshot of API Center platform API catalog in VS Code extension." :::
 
 1. After signing in, select **APIs** to list the APIs in the API center. Expand an API to explore its versions and definitions.
 
-    :::image type="content" source="media/enable-data-view-vscode-extension/api-center-pane-apis.png" alt-text="Screenshot of API Center Data View with APIs in VS Code extension." :::
-1. Repeat the preceding steps to connect to more API centers for which you have access.
+    :::image type="content" source="media/enable-platform-api-catalog-vscode-extension/api-center-pane-apis.png" alt-text="Screenshot of API Center platform API catalog with APIs in VS Code extension." :::
+
+1. Repeat the preceding steps to connect to more API centers, if access is configured.
 
 ## Discover and consume APIs
 
-The Azure API Center data view helps developers discover API details and start API client development. Right-click on an API definition in the data view to access these features:
+The Azure API Center platform API catalog helps enterprise developers discover API details and start API client development. Developers can access the following features by right-clicking on an API definition in the platform API catalog:
 
 * **Export API specification document** - Export an API specification from a definition and then download it as a file
 * **Generate API client** - Use the Microsoft Kiota extension to generate an API client for their favorite language
@@ -123,16 +128,16 @@ The Azure API Center data view helps developers discover API details and start A
 
 ### Error: Cannot read properties of undefined (reading 'nextLink')
 
-Under certain conditions, a user might encounter the following error message after signing into the API Center data view and expanding the APIs list for an API center:
+Under certain conditions, a user might encounter the following error message after signing into the API Center platform API catalog and expanding the APIs list for an API center:
 
 `Error: Cannot read properties of undefined (reading 'nextLink')`
 `
 
-Check that the user is assigned the **Azure API Center Data Reader** role in the API center. If necessary, reassign the role to the user. Then, refresh the API Center data view in the Visual Studio Code extension.
+Check that the user is assigned the **Azure API Center Data Reader** role in the API center. If necessary, reassign the role to the user. Then, refresh the API Center platform API catalog in the Visual Studio Code extension.
 
 ### Unable to sign in to Azure
 
-If users who have been assigned the **Azure API Center Data Reader** role can't complete the sign-in flow after selecting **Sign in to Azure** in the data view, there might be a problem with the configuration of the connection.
+If users who have been assigned the **Azure API Center Data Reader** role can't complete the sign-in flow after selecting **Sign in to Azure** in the platform API catalog, there might be a problem with the configuration of the connection.
 
 Check the settings in the app registration you configured in Microsoft Entra ID. Confirm the values of the application (client) ID and the directory (tenant) ID in the app registration and the runtime URL of the API center. Then, set up the connection to the API center again.
 

articles/api-center/includes/vscode-extension-prerelease-features.md

@@ -0,0 +1,14 @@
+---
+title: Include file
+description: Include file
+services: api-center
+author: dlepow
+
+ms.service: azure-api-center
+ms.topic: include
+ms.date: 09/23/2024
+ms.author: danlep
+ms.custom: Include file
+---
+
+When installing the extension from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=apidev.azure-api-center&ssr=false#overview), you can choose to install the release version or a pre-release version. Switch between the two versions at any time by using the extension's **Manage** button context menu in the Extensions view.