wscon

Author: gitName

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

@@ -100,15 +100,16 @@ Using the developer portal, API consumers can:
   * Download API definitions
   * Manage API keys
 
-## API platform deployment models
+## Federated API platform deployment with workspaces
 
-Azure API Management supports several deployment models for managing an organization's APIs, including *centralized*, *siloed*, and *federated*. The models offer different degrees of centralized control over the API platform infrastructure and autonomy of teams that produce and manage APIs. 
+Azure API Management supports several deployment models for managing an organization's API portfolio, including *centralized*, *siloed*, and *federated*. The models offer different degrees of centralized control over the API platform infrastructure, API governance, and API discovery. For organizations that want to manage API complexity by empowering decentralized teams to develop and manage their own APIs, API Management supports a federated model with workspaces.
 
-See the following table for a comparison of these models.
+[!INCLUDE [workspaces-benefits](../../includes/workspaces-benefits.md)]
 
-[!INCLUDE [api-management-platform-deployment-models](../../includes/api-management-platform-deployment-models.md)]
+**More information**:
 
-For example, a centralized model may be appropriate for smaller organizations that prioritize uniform API governance and cost-efficiency, while a federated model may be best for organizations that want to empower decentralized teams to develop and manage their own APIs using [workspaces](#workspaces). 
+* [Workspaces in API Management](workspaces-overview.md)
+* [API Management deployment models](workspaces-overview.md#centralized-api-platform-and-decentralized-api-teams)
 
 ## API Management tiers
 

includes/media/api-management-platform-deployment-models/centralized.png renamed to articles/api-management/media/workspaces-overview/centralized.png

@@ -18,8 +18,7 @@ ms.author: danlep
 
 Today, organizations increasingly face challenges in managing a proliferation of APIs. As the number of APIs and API development teams grows, so does the complexity of managing them. This complexity can lead to increased operational overhead, security risks, and reduced agility. On the one hand, organizations want to establish a centralized API infrastructure to ensure API governance, security, and compliance. On the other hand, they want their API teams to innovate and respond quickly to business needs, without the overhead of managing an API platform.
 
-In API Management, *workspaces* bring a new level of autonomy to an organization's API teams, enabling them to create, manage, and publish APIs faster, more reliably, securely, and productively within an API Management service. By providing isolated administrative access and API runtime, workspaces empower API teams while allowing the API platform team to retain oversight. This includes central monitoring, enforcement of API policies and compliance, and publishing APIs for discovery through a unified developer portal. 
-
+[!INCLUDE [workspaces-benefits](../../includes/workspaces-benefits.md)]
 Workspaces function like "folders" within an API Management service:
 
 * Each workspace contains APIs, products, subscriptions, named values, and related resources. 

includes/media/api-management-platform-deployment-models/federated.png renamed to articles/api-management/media/workspaces-overview/federated.png

@@ -0,0 +1,10 @@
+---
+author: dlepow
+ms.service: azure-api-management
+ms.topic: include
+ms.date: 08/08/2023
+ms.author: danlep
+---
+
+In API Management, *workspaces* bring a new level of autonomy to an organization's API teams, enabling them to create, manage, and publish APIs faster, more reliably, securely, and productively within an API Management service. By providing isolated administrative access and API runtime, workspaces empower API teams while allowing the API platform team to retain oversight. This includes central monitoring, enforcement of API policies and compliance, and publishing APIs for discovery through a unified developer portal.
+