update per Raj

hhunter-ms · hhunter-ms · commit 97b446916c3c · 2024-08-02T16:02:42.000-04:00
Signed-off-by: Hannah Hunter &lt;hannahhunter@microsoft.com&gt;
diff --git a/articles/container-apps/TOC.yml b/articles/container-apps/TOC.yml
@@ -245,38 +245,41 @@
           href: workload-profiles-manage-portal.md
 - name: Microservices
   items:
-  - name: Overview
-    href: dapr-overview.md
-  - name: Get started
-    items:
-    - name: Connect to Azure services
-      href: dapr-component-connection.md        
-    - name: Enable Dapr
-      href: enable-dapr.md
-  - name: Configure
-    items:
-    - name: Dapr components
-      href: dapr-components.md
-    - name: Dapr component resiliency (preview)
-      href: dapr-component-resiliency.md
-    - name: Scale Dapr apps with KEDA using Bicep
-      href: dapr-keda-scaling.md
-    - name: Enable token authentication for Dapr requests 
-      href: dapr-authentication-token.md
-  - name: Tutorials
-    items:
-    - name: Microservices communication using Pub/Sub
-      href: microservices-dapr-pubsub.md
-    - name: Event-driven work using Bindings
-      href: microservices-dapr-bindings.md
-    - name: Microservices communication using Service Invocation
-      href: microservices-dapr-service-invoke.md
-    - name: Deploy using the Dapr extension for Azure Functions
-      href: dapr-functions-extension.md
-    - name: Deploy using Azure CLI
-      href: microservices-dapr.md
-    - name: Deploy using ARM or Bicep
-      href: microservices-dapr-azure-resource-manager.md
+    - name: Developing with Dapr
+      items:
+      - name: Overview
+        href: dapr-overview.md
+        displayName: Developing with Dapr overview
+      - name: Get started
+        items:
+        - name: Connect to Azure services via Dapr components
+          href: dapr-component-connection.md
+        - name: Enable Dapr
+          href: enable-dapr.md
+      - name: Configure
+        items:
+        - name: Dapr components
+          href: dapr-components.md
+        - name: Dapr component resiliency (preview)
+          href: dapr-component-resiliency.md
+        - name: Scale Dapr apps with KEDA using Bicep
+          href: dapr-keda-scaling.md
+        - name: Enable token authentication for Dapr requests
+          href: dapr-authentication-token.md
+      - name: Tutorials
+        items:
+        - name: Microservices communication using Dapr Pub/Sub
+          href: microservices-dapr-pubsub.md
+        - name: Event-driven work using Dapr Bindings
+          href: microservices-dapr-bindings.md
+        - name: Microservices communication using Dapr Service Invocation
+          href: microservices-dapr-service-invoke.md
+        - name: Deploy using the Dapr extension for Azure Functions
+          href: dapr-functions-extension.md
+        - name: Deploy using Azure CLI
+          href: microservices-dapr.md
+        - name: Deploy using ARM or Bicep
+          href: microservices-dapr-azure-resource-manager.md
 - name: Networking, ingress, and network security
   items:
     - name: Architecture overview
diff --git a/articles/container-apps/dapr-authentication-token.md b/articles/container-apps/dapr-authentication-token.md
@@ -3,9 +3,9 @@ title: Enable token authentication for Dapr requests
 description: Learn more about enabling token authentication for Dapr requests to your container app in Azure Container Apps.
 ms.author: hannahhunter
 author: hhunter-ms
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: how-to 
-ms.date: 05/16/2023
+ms.date: 08/02/2024
 ---
 
 # Enable token authentication for Dapr requests
diff --git a/articles/container-apps/dapr-component-connection.md b/articles/container-apps/dapr-component-connection.md
@@ -4,9 +4,9 @@ description: Easily create Dapr components via the Azure Container Apps portal.
 author: hhunter-ms
 ms.author: hannahhunter
 ms.reviewer: nickgreenf
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: how-to 
-ms.date: 12/20/2023
+ms.date: 08/02/2024
 ms.custom: template-tutorial, service-connector, build-2023, engagement
 ---
 
diff --git a/articles/container-apps/dapr-component-resiliency.md b/articles/container-apps/dapr-component-resiliency.md
@@ -4,9 +4,9 @@ titleSuffix: Azure Container Apps
 description: Learn how to make your Dapr components resilient in Azure Container Apps.
 services: container-apps
 author: hhunter-ms
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: conceptual
-ms.date: 02/22/2024
+ms.date: 08/02/2024
 ms.author: hannahhunter
 ms.custom: ignite-fall-2023, ignite-2023, devx-track-azurecli
 # Customer Intent: As a developer, I'd like to learn how to make my container apps resilient using Azure Container Apps.
diff --git a/articles/container-apps/dapr-components.md b/articles/container-apps/dapr-components.md
@@ -3,10 +3,10 @@ title: Dapr components in Azure Container Apps
 description: Learn more about how Dapr components work on your Azure Container App service to develop applications.
 ms.author: hannahhunter
 author: hhunter-ms
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: build-2023
 ms.topic: conceptual
-ms.date: 04/29/2024
+ms.date: 08/02/2024
 ---
 
 # Dapr components in Azure Container Apps
diff --git a/articles/container-apps/dapr-functions-extension.md b/articles/container-apps/dapr-functions-extension.md
@@ -5,9 +5,9 @@ description: Learn how to use and deploy the Azure Functions with Dapr extension
 author: hhunter-ms
 ms.author: hannahhunter
 ms.reviewer: paulyuk
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: how-to
-ms.date: 10/30/2023
+ms.date: 08/02/2024
 ms.custom: references_regions
 # Customer Intent: I'm a developer who wants to use the Dapr extension for Azure Functions in my Dapr-enabled container app
 ---
diff --git a/articles/container-apps/dapr-keda-scaling.md b/articles/container-apps/dapr-keda-scaling.md
@@ -4,7 +4,7 @@ titleSuffix: "Azure Container Apps"
 description: Learn how to use KEDA scalers to scale an Azure Container App and its Dapr sidecar. 
 author: hhunter-ms
 ms.author: hannahhunter
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: devx-track-bicep
 ms.topic: conceptual 
 ms.date: 04/17/2023
diff --git a/articles/container-apps/dapr-overview.md b/articles/container-apps/dapr-overview.md
@@ -3,15 +3,15 @@ title: Microservice APIs powered by Dapr
 description: Learn more about using Dapr on your Azure Container App service to develop applications.
 ms.author: hannahhunter
 author: hhunter-ms
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: build-2023
 ms.topic: conceptual
-ms.date: 04/22/2024
+ms.date: 08/02/2024
 ---
 
 # Microservice APIs powered by Dapr
 
-Azure Container Apps provides serverless and versionless APIs powered by [Distributed Application Runtime (Dapr)][dapr-concepts] that help you write and implement simple, portable, resilient, and secured microservices. Dapr works together with Azure Container Apps as an abstraction layer to provide a low-maintenance, serverless, and scalable platform. Azure Container Apps offers a selection of fully-managed Dapr APIs, components, and features, catered specifically to microservice scenarios. Simply [enable and configure Dapr][dapr-enable] as usual in your container app environment.
+Azure Container Apps provides APIs powered by [Distributed Application Runtime (Dapr)][dapr-concepts] that help you write and implement simple, portable, resilient, and secured microservices. Dapr works together with Azure Container Apps as an abstraction layer to provide a low-maintenance and scalable platform. Azure Container Apps offers a selection of fully-managed Dapr APIs, components, and features, catered specifically to microservice scenarios. Simply [enable and configure Dapr][dapr-enable] as usual in your container app environment.
 
 ## How the microservices APIs work with your container app
 
diff --git a/articles/container-apps/faq.yml b/articles/container-apps/faq.yml
@@ -5,7 +5,7 @@ metadata:
   keywords: azure container apps, frequently asked questions
   author: craigshoemaker
   ms.topic: faq
-  ms.service: container-apps
+  ms.service: azure-container-apps
   ms.custom:
     - ignite-2023
   ms.date: 05/15/2024
@@ -80,9 +80,9 @@ sections:
           While Tier 1 components are fully supported, Tier 2 components are supported with best effort. [Learn more.](./dapr-overview.md#supported-dapr-apis-components-and-tooling)
 
       - question: |
-          What does "versionless" Dapr mean?
+          What is the Dapr version release cadence in Azure Container Apps?
         answer: |
-          Instead of relying on Dapr open source's release cadence, the Microservice APIs provided in Azure Container Apps are fully-managed and catered specifically to use in a container apps environment. 
+          Dapr's typical release timeline is up to six weeks after [the Dapr OSS release](https://docs.dapr.io/operations/support/support-release-policy/). The latest Dapr version is made available in Azure Container Apps after rigorous testing. Rolling out to all regions can take roughly up to two weeks. 
 
       - question: |
           How can I request a Dapr feature enhancement for Azure Container Apps?
diff --git a/articles/container-apps/microservices-dapr-bindings.md b/articles/container-apps/microservices-dapr-bindings.md
@@ -1,25 +1,25 @@
 ---
-title: "Tutorial: Event-driven work using Microservices Bindings API"
+title: "Tutorial: Event-driven work using Dapr Bindings"
 titleSuffix: "Azure Container Apps"
-description: Deploy a sample application that leverages the Microservices Bindings API, powered by Dapr.
+description: Deploy a sample application to Azure Container Apps that leverages the Dapr Bindings API.
 author: hhunter-ms
 ms.author: hannahhunter
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: devx-track-dotnet, devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 04/08/2024
+ms.date: 08/02/2024
 zone_pivot_group_filename: container-apps/dapr-zone-pivot-groups.json
 zone_pivot_groups: dapr-languages-set
 ---
 
-# Tutorial: Event-driven work using Microservices Bindings API 
+# Tutorial: Event-driven work using Dapr Bindings 
 
-In this tutorial, you create a microservice to demonstrate how [the Microservices Bindings API](./dapr-overview.md) (powered by Dapr) works with external systems as inputs and outputs. You'll:
+In this tutorial, you create a microservice to demonstrate [Dapr's Bindings API](https://docs.dapr.io/developing-applications/building-blocks/bindings/bindings-overview/) to work with external systems as inputs and outputs. You'll:
 > [!div class="checklist"]
 > * Run the application locally with the Dapr CLI. 
 > * Deploy the application to Azure Container Apps via the Azure Developer CLI with the provided Bicep. 
 
-The service listens to input binding events from a system CRON and then outputs the contents of local data to a PostgreSQL output binding.
+The service listens to input binding events from a system CRON and then outputs the contents of local data to a PostreSql output binding.
 
 :::image type="content" source="media/microservices-dapr-azd/bindings-quickstart.png" alt-text="Diagram of the binding application.":::
 
@@ -576,7 +576,7 @@ azd down
 
 ## Next steps
 
-- Learn more about [deploying microservices to Azure Container Apps](./microservices-dapr.md).
+- Learn more about [deploying microservices using Dapr to Azure Container Apps](./microservices-dapr.md).
 - [Enable token authentication for Dapr requests.](./dapr-authentication-token.md)
 - Learn more about [Azure Developer CLI](/azure/developer/azure-developer-cli/overview) and [making your applications compatible with `azd`](/azure/developer/azure-developer-cli/make-azd-compatible).
 - [Scale your applications using KEDA scalers](./dapr-keda-scaling.md)
diff --git a/articles/container-apps/microservices-dapr-pubsub.md b/articles/container-apps/microservices-dapr-pubsub.md
@@ -1,23 +1,23 @@
 ---
-title: "Tutorial: Microservices communication using Microservices Publish and Subscribe API"
+title: "Tutorial: Microservices communication using Dapr Publish and Subscribe"
 titleSuffix: "Azure Container Apps"
-description: Enable two sample applications to send and receive messages and leverage the Microservices pub/sub API, powered by Dapr.
+description: Enable two sample applications to send and receive messages and leverage the Dapr pub/sub API.
 author: hhunter-ms
 ms.author: hannahhunter
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: devx-track-dotnet, devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 02/22/2024
+ms.date: 08/02/2024
 zone_pivot_group_filename: container-apps/dapr-zone-pivot-groups.json
 zone_pivot_groups: dapr-languages-set
 ---
 
-# Tutorial: Microservices communication using Microservices Publish and Subscribe API
+# Tutorial: Microservices communication using Dapr Publish and Subscribe
 
-In this tutorial, you create publisher and subscriber microservices that leverage [the Microservices Pub/sub API](./dapr-overview.md#supported-dapr-apis-components-and-tooling) (powered by Dapr) to communicate using messages for event-driven architectures. You'll:
+In this tutorial, you create publisher and subscriber microservices that leverage [the Dapr Pub/sub API](./dapr-overview.md#supported-dapr-apis-components-and-tooling) to communicate using messages for event-driven architectures. You'll:
 
 > [!div class="checklist"]
-> * Create a publisher microservice and a subscriber microservice that leverage the pub/sub API to communicate using messages for event-driven architectures. 
+> * Create a publisher microservice and a subscriber microservice that leverage the [Dapr pub/sub API](https://docs.dapr.io/developing-applications/building-blocks/pubsub/pubsub-overview/) to communicate using messages for event-driven architectures.  
 > * Deploy the application to Azure Container Apps via the Azure Developer CLI with provided Bicep. 
 
 The sample pub/sub project includes:
diff --git a/articles/container-apps/microservices-dapr-service-invoke.md b/articles/container-apps/microservices-dapr-service-invoke.md
@@ -1,20 +1,20 @@
 ---
-title: "Tutorial: Microservices communication using the Service Invocation API"
+title: "Tutorial: Microservices communication using Dapr Service Invocation"
 titleSuffix: "Azure Container Apps"
-description: Enable two sample applications to communicate and leverage the Microservices Service Invocation API, powered by Dapr.
+description: Enable two sample Dapr applications to communicate and leverage Azure Container Apps.
 author: hhunter-ms
 ms.author: hannahhunter
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.custom: devx-track-dotnet, devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 04/08/2024
+ms.date: 08/02/2024
 zone_pivot_group_filename: container-apps/dapr-zone-pivot-groups.json
 zone_pivot_groups: dapr-languages-set
 ---
 
-# Tutorial: Microservices communication using the Service Invocation API
+# Tutorial: Microservices communication using Dapr Service Invocation
 
-In this tutorial, you create and run two microservices that communicate securely using auto-mTLS and reliably using built-in retries via [the Microservices Service Invocation API](./dapr-overview.md#supported-dapr-apis-components-and-tooling), powered by Dapr. You'll:
+In this tutorial, you create and run two microservices that communicate securely using auto-mTLS and reliably using built-in retries via [the Dapr Service Invocation API](./dapr-overview.md#supported-dapr-apis-components-and-tooling). You'll:
 
 > [!div class="checklist"]
 > * Run the application locally.
@@ -703,6 +703,6 @@ azd down
 
 ## Next steps
 
-- Learn more about [deploying applications to Azure Container Apps](./microservices-dapr.md).
+- Learn more about [deploying Dapr applications to Azure Container Apps](./microservices-dapr.md).
 - [Enable token authentication for Dapr requests.](./dapr-authentication-token.md)
 - Learn more about [Azure Developer CLI](/azure/developer/azure-developer-cli/overview) and [making your applications compatible with `azd`](/azure/developer/azure-developer-cli/make-azd-compatible).
diff --git a/articles/container-apps/microservices.md b/articles/container-apps/microservices.md
@@ -3,9 +3,9 @@ title: Microservices with Azure Containers Apps
 description: Build a microservice in Azure Container Apps.
 services: container-apps
 author: craigshoemaker
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: conceptual
-ms.date: 02/22/2024
+ms.date: 08/02/2024
 ms.author: cshoe
 ms.custom: build-2023
 ---
@@ -16,19 +16,19 @@ ms.custom: build-2023
 
 - Independent [scaling](scale-app.md), [versioning](application-lifecycle-management.md), and [upgrades](application-lifecycle-management.md)
 - [Service discovery](connect-apps.md)
-- [Microservices APIs](./dapr-overview.md)
+- [Dapr integration](./dapr-overview.md)
 
 :::image type="content" source="media/microservices/azure-container-services-microservices.png" alt-text="Container apps are deployed as microservices.":::
 
 A Container Apps [environment](environment.md) provides a security boundary around a group of container apps. A single container app typically represents a microservice, which is composed of container apps made up of one or more [containers](containers.md).
 
 You can add [**Azure Functions**](https://aka.ms/functionsonaca) and [**Azure Spring Apps**](https://aka.ms/asaonaca) to your Azure Container Apps environment.
 
-## Microservices APIs powered by Dapr
+## Dapr integration
 
-When implementing a system composed of microservices, function calls are spread across the network. To support the distributed nature of microservices, you need to account for failures, retries, and timeouts. Azure Container Apps features the building blocks for running microservices, powered by [Dapr](https://docs.dapr.io/concepts/overview/), which provide an even richer microservices programming model. These Microservices APIs includes features like observability, pub/sub, and service-to-service invocation with mutual TLS, retries, and more.
+When implementing a system composed of microservices, function calls are spread across the network. To support the distributed nature of microservices, you need to account for failures, retries, and timeouts. While Container Apps features the building blocks for running microservices, use of [Dapr](https://docs.dapr.io/concepts/overview/) provides an even richer microservices programming model. Dapr includes features like observability, pub/sub, and service-to-service invocation with mutual TLS, retries, and more.
 
-For more information on using the Microservices APIs, see [the Microservices APIs overview](dapr-overview.md).
+For more information on using Dapr, see [Build microservices with Dapr](microservices-dapr.md).
 
 ## Next steps
 
diff --git a/articles/container-apps/service-discovery-resiliency.md b/articles/container-apps/service-discovery-resiliency.md
@@ -4,9 +4,9 @@ titleSuffix: Azure Container Apps
 description: Learn how to apply container app to container app resiliency when using the application's service name in Azure Container Apps.
 services: container-apps
 author: hhunter-ms
-ms.service: container-apps
+ms.service: azure-container-apps
 ms.topic: conceptual
-ms.date: 02/22/2024
+ms.date: 08/02/2024
 ms.author: hannahhunter
 ms.custom: ignite-fall-2023, ignite-2023, devx-track-azurecli
 # Customer Intent: As a developer, I'd like to learn how to make my container apps resilient using Azure Container Apps.
@@ -17,7 +17,7 @@ ms.custom: ignite-fall-2023, ignite-2023, devx-track-azurecli
 With Azure Container Apps resiliency, you can proactively prevent, detect, and recover from service request failures using simple resiliency policies. In this article, you learn how to configure Azure Container Apps resiliency policies when initiating requests using Azure Container Apps service discovery.
 
 > [!NOTE]
-> Currently, resiliency policies can't be applied to requests made using the Microservices Service Invocation API. 
+> Currently, resiliency policies can't be applied to requests made using the Dapr Service Invocation API. 
 
 Policies are in effect for each request to a container app. You can tailor policies to the container app accepting requests with configurations like:
 - The number of retries
@@ -488,4 +488,4 @@ For example, if you set the *Resiliency Request Retries* metric in the *test-app
 
 ## Related content
 
-See how resiliency works for [Dapr open source components in Azure Container Apps](./dapr-component-resiliency.md).
+See how resiliency works for [Dapr components in Azure Container Apps](./dapr-component-resiliency.md).
