update overview intro

hhunter-ms · hhunter-ms · commit cd97d9ed81f9 · 2024-04-08T10:42:37.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
@@ -219,7 +219,7 @@
       href: enable-dapr.md
   - name: Configure
     items:
-    - name: Components
+    - name: Dapr components
       href: dapr-components.md
     - name: Dapr component resiliency (preview)
       href: dapr-component-resiliency.md
diff --git a/articles/container-apps/dapr-overview.md b/articles/container-apps/dapr-overview.md
@@ -6,16 +6,24 @@ author: hhunter-ms
 ms.service: container-apps
 ms.custom: event-tier1-build-2022, ignite-2022, build-2023
 ms.topic: conceptual
-ms.date: 01/30/2024
+ms.date: 04/08/2024
 ---
 
 # Microservice APIs powered by Dapr
 
 Azure Container Apps provides serverless and versionless APIs powered by [Distributed Application Runtime (Dapr)][dapr-concepts] that run as a sidecar process that helps 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. [Enabling Dapr on your container app][dapr-enable] creates a secondary process alongside your application code that simplifies application intercommunication with Dapr via HTTP or gRPC.
 
-## Dapr in Azure Container Apps
+## Versionless Dapr in Azure Container Apps
 
-Configure Dapr for your container apps environment with a [Dapr-enabled container app][dapr-enable], a [Dapr component configured for your solution][dapr-components], and a Dapr sidecar invoking communication between them. The following diagram demonstrates these core concepts related to Dapr in Azure Container Apps, using the pub/sub API as an example.
+Previously, Dapr worked as an extension in Azure Container Apps, mirroring Dapr open-source release cadence. Unfortunately, some APIs, features, and code enhancements offered in each open-source release bring in breaking changes to customer environments. 
+
+In an effort to meld smoothly with Azure Container Apps, Dapr now provides _versionless_ APIs. By taking a step back from the rapid release cadence of Dapr open-source, Dapr in Azure can now offer a selection of fully-managed Dapr APIs, components, and features, catered specifically to an Azure Container Apps scenario. 
+
+Simply enable and configure Dapr as usual in your container app environment and rely on up-to-date, fully-managed microservice APIs. 
+
+## How the microservices APIs work with your container app
+
+Configure microservices APIs for your container apps environment with a [Dapr-enabled container app][dapr-enable], a [Dapr component configured for your solution][dapr-components], and a Dapr sidecar invoking communication between them. The following diagram demonstrates these core concepts, using the pub/sub API as an example.
 
 :::image type="content" source="media/dapr-overview/dapr-in-aca.png" alt-text="Diagram demonstrating Dapr pub/sub and how it works in Container Apps.":::
 
diff --git a/articles/container-apps/microservices-dapr-bindings.md b/articles/container-apps/microservices-dapr-bindings.md
@@ -7,7 +7,7 @@ ms.author: hannahhunter
 ms.service: container-apps
 ms.custom: devx-track-dotnet, devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 02/22/2024
+ms.date: 04/08/2024
 zone_pivot_group_filename: container-apps/dapr-zone-pivot-groups.json
 zone_pivot_groups: dapr-languages-set
 ---
@@ -16,7 +16,7 @@ zone_pivot_groups: dapr-languages-set
 
 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:
 > [!div class="checklist"]
-> * Run the application locally. 
+> * 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.
@@ -50,7 +50,7 @@ Before deploying the application to Azure Container Apps, start by running the P
    cd bindings-dapr-nodejs-cron-postgres
    ```
 
-### Run the application
+### Run the application using the Dapr CLI
 
 1. From the sample's root directory, change directories to `db`.
 
@@ -227,7 +227,7 @@ Upon successful completion of the `azd up` command:
    cd bindings-dapr-python-cron-postgres
    ```
 
-### Run the application
+### Run the application using the Dapr CLI
 
 Before deploying the application to Azure Container Apps, start by running the PostgreSQL container and Python service locally with [Docker Compose](https://docs.docker.com/compose/) and Dapr.
 
@@ -404,7 +404,7 @@ Upon successful completion of the `azd up` command:
    cd bindings-dapr-csharp-cron-postgres
    ```
 
-### Run the application
+### Run the application using the Dapr CLI
 
 Before deploying the application to Azure Container Apps, start by running the PostgreSQL container and .NET service locally with [Docker Compose](https://docs.docker.com/compose/) and Dapr.
 
@@ -577,6 +577,6 @@ azd down
 ## Next steps
 
 - Learn more about [deploying microservices to Azure Container Apps](./microservices-dapr.md).
-- [Enable token authentication for requests.](./dapr-authentication-token.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
@@ -17,7 +17,7 @@ zone_pivot_groups: dapr-languages-set
 In this tutorial, you create publisher and subscriber microservices that leverage [the Microservices Pub/sub API](./dapr-overview.md#supported-microservices-apis) (powered by Dapr) to communicate using messages for event-driven architectures. You'll:
 
 > [!div class="checklist"]
-> * Create and run the application locally. 
+> * Create a publisher microservice and a subscriber microservice that leverage the pub/sub API 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:
@@ -53,7 +53,7 @@ Before deploying the application to Azure Container Apps, run the `order-process
    cd pubsub-dapr-nodejs-servicebus
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` subscriber service.
 
@@ -265,7 +265,7 @@ Before deploying the application to Azure Container Apps, run the `order-process
    cd pubsub-dapr-python-servicebus
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` subscriber service.
 
@@ -477,7 +477,7 @@ Before deploying the application to Azure Container Apps, run the `order-process
    cd pubsub-dapr-csharp-servicebus
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` subscriber service
 
@@ -679,6 +679,6 @@ azd down
 ## Next steps
 
 - Learn more about [deploying applications to Azure Container Apps](./microservices-dapr.md).
-- [Enable token authentication for requests.](./dapr-authentication-token.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-service-invoke.md b/articles/container-apps/microservices-dapr-service-invoke.md
@@ -7,7 +7,7 @@ ms.author: hannahhunter
 ms.service: container-apps
 ms.custom: devx-track-dotnet, devx-track-js, devx-track-python
 ms.topic: how-to
-ms.date: 02/22/2024
+ms.date: 04/08/2024
 zone_pivot_group_filename: container-apps/dapr-zone-pivot-groups.json
 zone_pivot_groups: dapr-languages-set
 ---
@@ -53,7 +53,7 @@ Before deploying the application to Azure Container Apps, start by running the `
    cd svc-invoke-dapr-nodejs
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` service.
 
@@ -273,7 +273,7 @@ Before deploying the application to Azure Container Apps, start by running the `
    cd svc-invoke-dapr-python
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` service.
 
@@ -492,7 +492,7 @@ Before deploying the application to Azure Container Apps, start by running the `
    cd svc-invoke-dapr-csharp
    ```
 
-### Run the applications
+### Run the applications using the Dapr CLI
 
 Start by running the `order-processor` callee service.
 
@@ -704,5 +704,5 @@ azd down
 ## Next steps
 
 - Learn more about [deploying applications to Azure Container Apps](./microservices-dapr.md).
-- [Enable token authentication for requests.](./dapr-authentication-token.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).
