.NET provider release notes 8.2.0 (#1054)

* add release notes first draft

* update notes

* mention setclientfactory

* mention allocationid

* update dates

* Update releaseNotes/MicrosoftExtensionsConfigurationAzureAppConfiguration.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: amerjusupovic

releaseNotes/MicrosoftAzureAppConfigurationAspNetCore.md

@@ -1,6 +1,9 @@
 # Microsoft.Azure.AppConfiguration.AspNetCore
 [Source code][source_code] | [Package (NuGet)][package]
 
+## 8.2.0 - May 14th, 2025
+* Updated `Microsoft.Extensions.Configuration.AzureAppConfiguration` reference to `8.2.0`. See the [release notes](./MicrosoftExtensionsConfigurationAzureAppConfiguration.md) for more information on the changes.
+
 ## 8.1.2 - April 22nd, 2025
 * Updated `Microsoft.Extensions.Configuration.AzureAppConfiguration` reference to `8.1.2`. See the [release notes](./MicrosoftExtensionsConfigurationAzureAppConfiguration.md) for more information on the changes.
 

releaseNotes/MicrosoftAzureAppConfigurationFunctionsWorker.md

@@ -1,6 +1,9 @@
 # Microsoft.Azure.AppConfiguration.Functions.Worker
 [Source code][source_code] | [Package (NuGet)][package]
 
+## 8.2.0 - May 14th, 2025
+* Updated `Microsoft.Extensions.Configuration.AzureAppConfiguration` reference to `8.2.0`. See the [release notes](./MicrosoftExtensionsConfigurationAzureAppConfiguration.md) for more information on the changes.
+
 ## 8.1.2 - April 22nd, 2025
 * Updated `Microsoft.Extensions.Configuration.AzureAppConfiguration` reference to `8.1.2`. See the [release notes](./MicrosoftExtensionsConfigurationAzureAppConfiguration.md) for more information on the changes.
 

releaseNotes/MicrosoftExtensionsConfigurationAzureAppConfiguration.md

@@ -1,6 +1,29 @@
 # Microsoft.Extensions.Configuration.AzureAppConfiguration
 [Source code][source_code] | [Package (NuGet)][package]
 
+## 8.2.0 - May 14th, 2025
+### Enhancements
+* Updated the existing `Select` APIs with the new parameter `tagFilters` to support filtering key-values and feature flags by tags.
+
+   ```cs
+   public AzureAppConfigurationOptions Select(string keyFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)
+   ```
+
+   ```cs
+   public FeatureFlagOptions Select(string featureFlagFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)
+   ```
+* Added an `ActivitySource` called `Microsoft.Extensions.Configuration.AzureAppConfiguration` to support instrumentation. A `Load` activity will start when configuration is initially built and the `Refresh` activity will start when a refresh is triggered. [#645](https://github.com/Azure/AppConfiguration-DotnetProvider/pull/645)
+* This is the first stable release of the `AzureAppConfigurationOptions.SetClientFactory` API introduced in 8.2.0-preview. [#380](https://github.com/Azure/AppConfiguration-DotnetProvider/issues/380)
+
+   ```cs
+   public AzureAppConfigurationOptions SetClientFactory(IAzureClientFactory<ConfigurationClient> factory)
+   ```
+
+### Other Changes
+* Removed the `FeatureFlagId` property from feature flag telemetry. [#655](https://github.com/Azure/AppConfiguration-DotnetProvider/pull/655)
+* Shortened default network timeout for requests to App Configuration to improve failover speed and retry responsiveness. [#657](https://github.com/Azure/AppConfiguration-DotnetProvider/pull/657)
+* This is the first stable release of `AllocationId` from feature flag telemetry metadata, which was introduced in 8.1.0-preview. [#600](https://github.com/Azure/AppConfiguration-DotnetProvider/pull/600)
+
 ## 8.1.2 - April 22nd, 2025
 ### Bug Fixes
 * Calling `IServiceCollection.AddAzureAppConfiguration` now correctly adds an instance of `IConfigurationRefresherProvider` to the service collection only the first time it is called instead of adding an instance on each invocation. [#611](https://github.com/Azure/AppConfiguration-DotnetProvider/issues/611)