Merge pull request #293378 from zhiyuanliang-ms/zhiyuanliang/add-feature-overview

Azure App Configuration - Add feature status overview

Author: JamesJBarnett

articles/azure-app-configuration/TOC.yml

@@ -302,28 +302,47 @@
           href: ./rest-api-versioning.md
   - name: Client libraries
     items:
-    - name: .NET provider
-      href: /dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration
-    - name: .NET Framework builder
-      href: https://go.microsoft.com/fwlink/?linkid=2074663
-    - name: Java Spring provider
-      href: https://go.microsoft.com/fwlink/?linkid=2180917
-    - name: Python provider
-      href: https://pypi.org/project/azure-appconfiguration-provider/
-    - name: JavaScript provider
-      href: ./reference-javascript-provider.md
-    - name: Azure SDK for .NET
-      href: https://go.microsoft.com/fwlink/?linkid=2092056
-    - name: Azure SDK for Java
-      href: https://go.microsoft.com/fwlink/?linkid=2098196
-    - name: Azure SDK for Python
-      href: https://go.microsoft.com/fwlink/?linkid=2103727
-    - name: Azure SDK for JavaScript
-      href: https://go.microsoft.com/fwlink/?linkid=2103664
-    - name: Azure SDK for Go
-      href: https://go.microsoft.com/fwlink/?linkid=2270866
+    - name: Overview
+      href: ./configuration-provider-overview.md
+    - name: .NET
+      items:
+      - name: API reference
+        href: /dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration
+      - name: Azure SDK for .NET
+        href: https://go.microsoft.com/fwlink/?linkid=2092056
+      - name: .NET Framework builder
+        href: https://go.microsoft.com/fwlink/?linkid=2074663
+    - name: Java Spring
+      items:
+      - name: Feature reference
+        href: https://go.microsoft.com/fwlink/?linkid=2180917
+      - name: Azure SDK for Java
+        href: https://go.microsoft.com/fwlink/?linkid=2098196
+    - name: Python
+      items:
+      - name: Feature reference
+        href: https://pypi.org/project/azure-appconfiguration-provider/
+      - name: Azure SDK for Python
+        href: https://go.microsoft.com/fwlink/?linkid=2103727
+    - name: JavaScript
+      items:
+      - name: Feature reference
+        href: ./reference-javascript-provider.md
+      - name: Azure SDK for JavaScript
+        href: https://go.microsoft.com/fwlink/?linkid=2103664
+    - name: Kubernetes
+      items:
+      - name: Feature reference
+        href: ./reference-kubernetes-provider.md
+    - name: Go
+      items:
+      - name: Azure SDK for Go
+        href: https://go.microsoft.com/fwlink/?linkid=2270866
+
   - name: Feature management
     items:
+    - name: Overview
+      href: ./feature-management-overview.md
     - name: .NET
       items:
       - name: Feature reference
@@ -352,8 +371,6 @@
     href: /cli/azure/appconfig
   - name: Azure PowerShell
     href: /powershell/module/az.appconfiguration/
-  - name: Kubernetes provider
-    href: reference-kubernetes-provider.md
   - name: Azure Policy built-ins
     displayName: samples, policies, definitions
     href: ./policy-reference.md

articles/azure-app-configuration/configuration-provider-overview.md

@@ -0,0 +1,66 @@
+---
+title: Configuration Provider Overview
+titleSuffix: Azure App Configuration
+description: Overview of configuration provider libraries of different programming languages.
+services: azure-app-configuration
+author: zhiyuanliang-ms
+ms.author: zhiyuanliang
+ms.service: azure-app-configuration
+ms.topic: overview
+ms.date: 01/22/2025
+#Customer intent: I want to learn about the configuration provider libraries of different languages, specifically to track their feature development status.
+---
+
+# Configuration Provider Overview
+
+The Azure App Configuration provider libraries enable developers to configure their applications using centralized configuration located in Azure App Configuration. The API design follows the patterns outlined by the common configuration system in different programming languages to make switching to Azure App Configuration a familiar and easy experience.
+
+> [!IMPORTANT]
+> The configuration provider libraries are higher-level integration libraries that support additional [features](#feature-development-status) in contrast to the Azure SDKs which provide low-level, direct interaction with the Azure App Configuration service.
+
+> [!NOTE]
+> If you use feature flags in Azure App Configuration, we recommend you to use the configuration provider alongside the [feature management](./feature-management-overview.md) libraries, which are designed to work together.
+
+## Configuration Provider Libraries
+
+Module | Platform | Sample | Release Notes
+------ | -------- | ------ | -------------
+[Microsoft.Extensions.Configuration.AzureAppConfiguration](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Extensions.Configuration.AzureAppConfiguration](https://img.shields.io/nuget/v/Microsoft.Extensions.Configuration.AzureAppConfiguration.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.AzureAppConfiguration/) | .NET Standard | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftExtensionsConfigurationAzureAppConfiguration.md)
+[Microsoft.Azure.AppConfiguration.AspNetCore](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Azure.AppConfiguration.AspNetCore](https://img.shields.io/nuget/v/Microsoft.Azure.AppConfiguration.AspNetCore.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore/) | ASP&#46;NET Core | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftAzureAppConfigurationAspNetCore.md)
+[Microsoft.Azure.AppConfiguration.Functions.Worker](https://github.com/Azure/AppConfiguration-DotnetProvider)<br/>[![Nuget: Microsoft.Azure.AppConfiguration.Functions.Worker](https://img.shields.io/nuget/v/Microsoft.Azure.AppConfiguration.Functions.Worker.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.Functions.Worker/) | Azure Functions<br/>(Isolated process) | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetCore/AzureFunction/FunctionAppIsolatedMode) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/MicrosoftAzureAppConfigurationFunctionsWorker.md)
+[Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration](https://github.com/aspnet/MicrosoftConfigurationBuilders/tree/main/src/AzureAppConfig)<br/>[![Nuget: Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration](https://img.shields.io/nuget/v/Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration.svg?color=blue)](https://www.nuget.org/packages/Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration/) | .NET Framework | [Sample](https://github.com/Azure/AppConfiguration/tree/main/examples/DotNetFramework/WebDemo) | [Release Notes](https://github.com/aspnet/MicrosoftConfigurationBuilders/releases)
+[spring-cloud-azure-appconfiguration-config](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-appconfiguration-config)<br/>[![Maven: spring-cloud-azure-appconfiguration-config](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-appconfiguration-config.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-appconfiguration-config) | Java Spring | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-starter-appconfiguration-config/spring-cloud-azure-starter-appconfiguration-config-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureAppConfigurationConfig.md)
+[spring-cloud-azure-appconfiguration-config-web](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-appconfiguration-config-web)<br/>[![Maven: spring-cloud-azure-appconfiguration-config-web](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-appconfiguration-config-web.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-appconfiguration-config-web) | Java Spring | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-starter-appconfiguration-config/spring-cloud-azure-starter-appconfiguration-config-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureAppConfigurationConfig.md)
+[azure-appconfiguration-provider](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration-provider)<br/>[![Pypi](https://img.shields.io/pypi/v/azure-appconfiguration-provider.svg?color=blue)](https://pypi.org/project/azure-appconfiguration-provider/) | Python | [Sample](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration-provider/samples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/AzureAppConfigurationProviderPython.md)
+[@azure/app-configuration-provider](https://github.com/Azure/AppConfiguration-JavaScriptProvider)<br/>[![Npm](https://img.shields.io/npm/v/@azure/app-configuration-provider?color=blue)](https://www.npmjs.com/package/@azure/app-configuration-provider) | JavaScript | [Sample](https://github.com/Azure/AppConfiguration-JavaScriptProvider/tree/main/examples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/JavaScriptProvider.md)
+
+## Feature Development Status
+
+This is an overview of each feature and its current status for different frameworks or programming languages.  
+
+- **GA (General Availability)**: The feature is fully released, considered stable, and ready for production use.  
+- **Preview**: The feature is available for early testing and feedback, but not yet fully stable or recommended for production use.  
+- **WIP (Work in Progress)**: The feature is actively being developed and not yet ready for release.
+- **N/A (Not Available)**: It is not planned to offer the feature for the specified framework or language.
+
+Feature | .NET | Spring | Kubernetes | Python | JavaScript
+------- | ---- | ------ | ---------- | ------ | ----------
+Connection String Authentication | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#load-configuration)
+Entra ID Authentication | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#load-configuration)
+Dynamic Refresh (Poll Mode) | GA | GA | GA | GA | GA
+Dynamic Refresh (Push Mode) | GA | GA | N/A | N/A | N/A
+Dynamic Refresh (Collection Monitoring) | WIP | WIP | GA | WIP | [GA](./reference-javascript-provider.md#configuration-refresh)
+JSON Content Type Handling | GA | GA | GA | GA | GA
+Configuration Setting Mapping | GA | N/A | N/A | N/A | N/A
+Key Vault References | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#key-vault-reference)
+Key Vault Secret Refresh | GA | WIP | GA | WIP | WIP
+Custom Key Vault Secret Resolution | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#key-vault-reference)
+Feature Flags | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#feature-flag)
+Variant Feature Flags | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#feature-flag)
+Feature Flag Telemetry | GA | GA | WIP | GA | GA
+Key Prefix Trim | GA | GA | GA | GA | [GA](./reference-javascript-provider.md#trim-prefix-from-keys)
+Configurable Startup Time-out | GA | WIP | N/A | WIP | WIP
+Replica Auto Discovery | GA | GA | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
+Replica Failover | GA | GA | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
+Replica Load Balancing | GA | WIP | GA | WIP | [GA](./reference-javascript-provider.md#geo-replication)
+Snapshots | GA | GA | GA | WIP | WIP

articles/azure-app-configuration/feature-management-overview.md

@@ -0,0 +1,50 @@
+---
+title: Feature Management Overview
+titleSuffix: Azure App Configuration
+description: Overview of feature management libraries of different programming languages.
+services: azure-app-configuration
+author: zhiyuanliang-ms
+ms.author: zhiyuanliang
+ms.service: azure-app-configuration
+ms.topic: overview
+ms.date: 01/22/2025
+#Customer intent: I want to learn about the feature management libraries of different languages, specifically to track their feature development status.
+---
+
+# Feature Management Overview
+
+Feature Management libraries provide standardized APIs for enabling feature flags within applications. Use these libraries to secure a consistent experience when developing applications that use patterns such as beta access, rollout, dark deployments, and more.
+
+## Feature Management Libraries
+
+Module | Platform | Sample | Release Notes
+------ | -------- | ------ | -------------
+[Microsoft.FeatureManagement](https://github.com/microsoft/FeatureManagement-Dotnet)<br/>[![Nuget: Microsoft.FeatureManagement](https://img.shields.io/nuget/v/Microsoft.FeatureManagement.svg?color=blue)](https://www.nuget.org/packages/Microsoft.FeatureManagement)| .NET Standard | [Sample](https://github.com/microsoft/FeatureManagement-Dotnet/tree/main/examples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/Microsoft.Featuremanagement.md)
+[Microsoft.FeatureManagement.AspNetCore](https://github.com/microsoft/FeatureManagement-Dotnet)<br/>[![Nuget: Microsoft.FeatureManagement.AspNetCore](https://img.shields.io/nuget/v/Microsoft.FeatureManagement.AspNetCore.svg?color=blue)](https://www.nuget.org/packages/Microsoft.FeatureManagement.AspNetCore) | ASP&#46;NET Core | [Sample](https://github.com/microsoft/FeatureManagement-Dotnet/tree/main/examples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/Microsoft.Featuremanagement.md)
+[spring-cloud-azure-feature-management](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-feature-management)<br/>[![Maven: spring-cloud-azure-feature-management](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-feature-management.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-feature-management) | Spring Boot | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-feature-management/spring-cloud-azure-feature-management-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureFeatureManagement.md)
+[spring-cloud-azure-feature-management-web](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-feature-management-web)<br/>[![Maven: spring-cloud-azure-feature-management-web](https://img.shields.io/maven-central/v/com.azure.spring/spring-cloud-azure-feature-management-web.svg?color=blue)](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-feature-management-web) | Spring Boot | [Sample](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/main/appconfiguration/spring-cloud-azure-feature-management-web/spring-cloud-azure-feature-management-web-sample) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/SpringCloudAzureFeatureManagement.md)
+[featuremanagement](https://github.com/microsoft/FeatureManagement-Python)<br/>[![PyPi](https://img.shields.io/pypi/v/FeatureManagement?color=blue)](https://pypi.org/project/FeatureManagement/) | Python | [Sample](https://github.com/microsoft/FeatureManagement-Python/tree/main/samples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/PythonFeatureManagement.md)
+[@microsoft/feature-management](https://github.com/microsoft/FeatureManagement-JavaScript)<br/>[![npm](https://img.shields.io/npm/v/@microsoft/feature-management?color=blue)](https://www.npmjs.com/package/@microsoft/feature-management) | JavaScript | [Sample](https://github.com/microsoft/FeatureManagement-JavaScript/tree/main/examples) | [Release Notes](https://github.com/Azure/AppConfiguration/blob/main/releaseNotes/JavaScriptFeatureManagement.md)
+
+## Feature Development Status
+
+This is an overview of each feature and its current status for different frameworks or programming languages.  
+
+- **GA (General Availability)**: The feature is fully released, considered stable, and ready for production use.  
+- **Preview**: The feature is available for early testing and feedback, but not yet fully stable or recommended for production use.  
+- **WIP (Work in Progress)**: The feature is actively being developed and not yet ready for release.
+- **N/A (Not Available)**: It is not planned to offer the feature for the specified framework or language.
+
+Feature | .NET | Spring | Python | JavaScript
+------- | ---- | ------ | ------ | ----------
+Targeting Filter | [GA](./feature-management-dotnet-reference.md#targeting) | GA | [GA](./feature-management-python-reference.md#targeting) | GA
+Targeting Exclusion | [GA](./feature-management-dotnet-reference.md#targeting-exclusion) | GA | [GA](./feature-management-python-reference.md#targeting-exclusion) | GA
+Time Window Filter | [GA](./feature-management-dotnet-reference.md#microsofttimewindow) | GA | [GA](./feature-management-python-reference.md#microsofttimewindow) | GA
+Recurring Time Window | [GA](./feature-management-dotnet-reference.md#microsofttimewindow) | GA | WIP | WIP
+Custom Feature Filter | [GA](./feature-management-dotnet-reference.md#implementing-a-feature-filter) | GA | [GA](./feature-management-python-reference.md#implementing-a-feature-filter) | GA
+Feature Filter Requirement Type (AND/OR) | [GA](./feature-management-dotnet-reference.md#requirementtype) | GA | [GA](./feature-management-python-reference.md#requirement_type) | GA
+Variant Feature Flag | [GA](./feature-management-dotnet-reference.md#variants) | GA | [GA](./feature-management-python-reference.md#variants) | GA
+Feature Flag Telemetry | [GA](./feature-management-dotnet-reference.md#telemetry) | GA | [GA](./feature-management-python-reference.md#telemetry) | GA
+Application Insights Integration | [GA](./feature-management-dotnet-reference.md#application-insights-telemetry) | GA | [GA](./feature-management-python-reference.md#application-insights-telemetry) | GA
+Feature Gate | [GA](./feature-management-dotnet-reference.md#controllers-and-actions) | GA | N/A | N/A
+Feature Gated Middleware | [GA](./feature-management-dotnet-reference.md#application-building) | GA | N/A | N/A

articles/azure-app-configuration/howto-geo-replication.md

@@ -171,7 +171,7 @@ const config = load(endpoint, credential, {
 ```
 
 > [!NOTE]
-> The automatic replica discovery support is available if you use version **2.0.0-preview.2** or later of [@azure/app-configuration-provider](https://www.npmjs.com/package/@azure/app-configuration-provider).
+> The automatic replica discovery support is available if you use version **2.0.0** or later of [@azure/app-configuration-provider](https://www.npmjs.com/package/@azure/app-configuration-provider).
 > The feature is not available for browser-based applications due to the restriction of browser security sandbox.
 
 ---
@@ -337,7 +337,7 @@ const config = load(endpoint, credential, {
 ```
 
 > [!NOTE]
-> Load balancing support is available if you use version **2.0.0-preview.2** or later of [@azure/app-configuration-provider](https://www.npmjs.com/package/@azure/app-configuration-provider).
+> Load balancing support is available if you use version **2.0.0** or later of [@azure/app-configuration-provider](https://www.npmjs.com/package/@azure/app-configuration-provider).
 
 ---
 

articles/azure-app-configuration/index.yml

@@ -166,6 +166,8 @@ landingContent:
           url: howto-variant-feature-flags-python.md
       - linkListType: reference
         links:
+        - text: Overview
+          url: feature-management-overview.md
         - text: .NET feature management
           url: feature-management-dotnet-reference.md
         - text: .NET feature management API reference
@@ -181,6 +183,8 @@ landingContent:
     linkLists:
       - linkListType: reference
         links:
+        - text: Overview
+          url: configuration-provider-overview.md
         - text: .NET provider
           url: /dotnet/api/Microsoft.Extensions.Configuration.AzureAppConfiguration
         - text: Java Spring provider