Merge pull request #292865 from hhunter-ms/hh-360399

[Dapr/ACA] Add versioning format and FAQ

Author: v-shils

articles/container-apps/dapr-overview.md

@@ -25,6 +25,17 @@ Configure microservices APIs for your container apps environment with a [Dapr-en
 | 2     | Dapr                             | The fully managed Dapr APIs are exposed to each container app through a Dapr sidecar. The Dapr APIs can be invoked from your container app via HTTP or gRPC. The Dapr sidecar runs on HTTP port 3500 and gRPC port 50001.                                                         |
 | 3     | Dapr component configuration     | Dapr uses a modular design where functionality is delivered as a component. Dapr components can be shared across multiple container apps. The Dapr app identifiers provided in the scopes array dictate which dapr-enabled container apps load a given component at runtime. |
 
+## Versioning
+
+Dapr versions in Azure Container Apps include:
+- A semantic versioning prefix, such as `1.13.6`, which denotes compatibility with the corresponding OSS Dapr runtime version APIs and related tools like SDKs, CLI, etc.
+- A `-msft.<number>` suffix, which denotes incorporating Azure-specific customizations for enhanced security and production readiness.
+
+The complete version format for Dapr in Azure Container Apps can look something like `1.13.6-msft.1`.
+
+> [!NOTE]
+> The `<number>` in the suffix may not always increment sequentially. For example, version `1.13.6-msft.3` may skip `1.13.6-msft.2`. 
+
 ## Supported Dapr APIs, components, and tooling
 
 ### Managed APIs

articles/container-apps/faq.yml

@@ -100,16 +100,28 @@ 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 is the Dapr version release cadence in Azure Container Apps?
+          How can I request a Dapr feature enhancement for Azure Container Apps?
+        answer:
+
+          You can submit a feature request via the [Azure Container Apps GitHub repository](https://github.com/microsoft/azure-container-apps/issues/new/choose). Make sure to include "Dapr" in the feature request title.
+
+      - question: |
+          Why do I see "-msft.<number>" version in my Container App Environment?
         answer: |
-          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 only after rigorous testing. Rolling out to all regions can take up to two weeks or longer. 
+          As `1.13.6-msft.1` is being rolled out across production regions, you may still see earlier versions (like `1.12.5` or `1.12.5-msft.6`). The `-msft.<number>` suffix indicates the specific customizations made for Azure Container Apps to enhance your experience.
 
       - question: |
-          How can I request a Dapr feature enhancement for Azure Container Apps?
+          How often are Dapr versions released for Azure Container Apps?
+        answer: |
+          Dapr's typical release timeline in Azure is up to six weeks after the Dapr OSS release. Rolling out to all regions can take up to two weeks or longer.
+          
+          Dapr versions are updated on a best-effort basis, prioritizing stability, rigorous testing, and customer impact to ensure seamless integration without breaking changes. Updates are applied automatically, ensuring you always have the latest secure version.
+
+      - question: |
+          Can I use a specific Dapr version for my environment?
         answer:
+          Custom version selection is **not supported**. Instead, your environment is automatically upgraded, maintaining the integrity of Dapr's fully managed and serverless offering in Azure Container Apps.
 
-          You can submit a feature request via the [Azure Container Apps GitHub repository](https://github.com/microsoft/azure-container-apps/issues/new/choose). Make sure to include "Dapr" in the feature request title.
-  
   - name: Dockerless deployments
     questions:
      - question: |