Merge pull request #281044 from dlepow/devproxy

[APIC] ToC and link to Dev Proxy content

Author: v-shils

articles/api-center/TOC.yml

@@ -32,8 +32,6 @@
             href: register-apis.md
           - name: 3 - Add environments and deployments
             href: configure-environments-deployments.md
-          - name: 4 - Discover shadow APIs
-            href: discover-shadow-apis-dev-proxy.md
 - name: API inventory
   items:
       - name: Manage inventory - Azure CLI
@@ -48,6 +46,8 @@
         href: metadata.md
       - name: Analyze APIs using linting rules
         href: enable-api-analysis-linting.md
+      - name: Discover shadow APIs with Dev Proxy
+        href: discover-shadow-apis-dev-proxy.md  
 - name: API discovery and consumption
   items:
       - name: Self-host Azure API Center portal

articles/api-center/discover-shadow-apis-dev-proxy.md

@@ -1,14 +1,14 @@
 ---
-title: Tutorial - Discover shadow APIs using Dev Proxy
-description: In this tutorial, you learn how to discover shadow APIs in your apps using Dev Proxy and onboard them to API Center.
+title: Discover shadow APIs using Dev Proxy
+description: Learn how to discover shadow APIs in your apps using Dev Proxy and onboard them to API Center.
 author: waldekmastykarz
 ms.service: api-center
-ms.topic: tutorial
+ms.topic: how-to
 ms.date: 07/15/2024
 ms.author: wmastyka 
 ---
 
-# Tutorial - Discover shadow APIs using Dev Proxy
+# Discover shadow APIs using Dev Proxy
 
 Using Azure API Center you catalog APIs used in your organization. This allows you to tell which APIs you use, where the API is in its lifecycle, and who to contact if there are issues. In short, having an up-to-date catalog of APIs helps you improve the governance-, compliance-, and security posture.
 

articles/api-center/overview.md

@@ -37,7 +37,7 @@ Create and use an API center for the following:
 
 * **Real-world API representation** - Add real-world information about each API including versions and definitions such as OpenAPI definitions. List API deployments and associate them with runtime environments, for example, representing Azure API Management or other API management solutions.
 
-* **API governance** - Organize and filter APIs and related resources using built-in and custom metadata, to help with API governance and discovery by API consumers. Set up linting and analysis to enforce API definition quality.  
+* **API governance** - Organize and filter APIs and related resources using built-in and custom metadata, to help with API governance and discovery by API consumers. Set up [linting and analysis](enable-api-analysis-linting.md) to enforce API definition quality. Integrate with tools such as Dev Proxy to ensure that apps don't use unregistered [shadow APIs](discover-shadow-apis-dev-proxy.md) or APIs that don't meet organizational standards.
 
 * **API discovery and reuse** - Enable developers and API program managers to discover APIs via the Azure portal, an API Center portal, and developer tools including a [Visual Studio Code extension](use-vscode-extension.md)​.