From e71ee54bff7d2a923d3d1a807a36c5ce0a188891 Mon Sep 17 00:00:00 2001 From: Matt Metcalf Date: Tue, 17 Mar 2026 13:47:45 -0700 Subject: [PATCH 1/6] Release Notes Skill --- .github/copilot-instructions.md | 59 ++++++ .github/skills/release-notes/SKILL.md | 174 ++++++++++++++++++ .../SpringCloudAzureAppConfigurationConfig.md | 10 + .../SpringCloudAzureFeatureManagement.md | 14 ++ 4 files changed, 257 insertions(+) create mode 100644 .github/copilot-instructions.md create mode 100644 .github/skills/release-notes/SKILL.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 00000000..a6c45bdd --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,59 @@ +# Copilot Instructions — Azure App Configuration + +This is the central hub repository for **Azure App Configuration**. It contains cross-language examples, documentation, configuration schemas, and release notes for the App Configuration ecosystem. + +## Repository Structure + +- `examples/` — Working sample applications across .NET, Java/Spring, Python, Go, and JavaScript +- `docs/` — Configuration type schemas (AI Chat, Key Vault Reference, KVSet) and integration guides +- `releaseNotes/` — Release notes for all App Configuration libraries and providers + +This is **not** a library repo — it is a reference and documentation repository. + +## Languages & Frameworks + +| Language | Frameworks | Location | +|----------|-----------|----------| +| .NET | ASP.NET Core, Azure Functions, .NET Framework | `examples/DotNetCore/`, `examples/DotNetFramework/` | +| Java | Spring Boot, Spring Cloud Azure | `examples/Spring/` | +| Python | Flask, Django, console apps | `examples/Python/` | +| Go | Gin, console apps | `examples/Go/` | +| JavaScript | Node.js | `examples/QuickStart/JavaScript/` | + +## Code Style + +### Python +- **Black** formatter: line-length=120, target Python 3.8+ +- **Pylint**: max-line-length=120 +- **MyPy**: type checking enabled +- Run formatting/linting via tox tasks defined in the workspace + +### All Languages +- Each example must be self-contained with its own README, dependencies, and setup instructions +- READMEs must include: Features, Prerequisites, Setup, and Running instructions +- Environment variables and connection strings must be documented but never hardcoded +- Secrets must use Key Vault references, never plain text in config + +## Adding or Modifying Examples + +- Follow the existing directory structure: `examples/{Language}/{ExampleName}/` +- Include a `README.md` with clear setup and run instructions +- List all prerequisites (SDKs, Azure resources, environment variables) +- Keep examples minimal and focused on demonstrating a single integration pattern +- Use the Azure App Configuration provider library for the target language + +## Documentation & Schemas + +- Configuration schemas live in `docs/ConfigurationTypes/` as versioned JSON Schema files +- Follow semantic versioning in schema filenames: `{Type}.v{Major}.{Minor}.{Patch}.schema.json` + +## Release Notes + +- Release notes are Markdown files in `releaseNotes/`, one per product +- Entries are in reverse chronological order (newest first) +- Each entry includes version number, date, and a bulleted list of changes + +## Security + +- Report vulnerabilities through MSRC (https://msrc.microsoft.com/create-report), never via public issues +- Never commit secrets, connection strings, or credentials diff --git a/.github/skills/release-notes/SKILL.md b/.github/skills/release-notes/SKILL.md new file mode 100644 index 00000000..fd48d9cf --- /dev/null +++ b/.github/skills/release-notes/SKILL.md @@ -0,0 +1,174 @@ +--- +name: release-notes +description: "Author and update release notes for Azure App Configuration libraries and providers. USE FOR: write release notes, add release note entry, update release notes, draft release notes, new version release notes, format release notes. DO NOT USE FOR: generating changelogs from git history, writing internal engineering notes." +--- + +# Release Notes Authoring Skill + +This skill guides the authoring of customer-facing release notes for Azure App Configuration libraries and providers. Release notes live in `releaseNotes/` and are the primary way customers learn about new versions. + +## Key Principle + +Release notes are for **customers**, not engineers. Every entry should help a customer decide whether to upgrade and understand what changed from their perspective. + +## File Location & Naming + +- All release notes go in `releaseNotes/` in this repository, even if the library has its own repo. +- One Markdown file per product (e.g., `MicrosoftExtensionsConfigurationAzureAppConfiguration.md`). +- If adding release notes for a **new product**, create a new file in `releaseNotes/`. + +## File Structure + +Each release notes file follows this structure: + +```markdown +# Product Name + +[Source code][source_code] | [Package (NuGet/npm/PyPI)][package] | [Samples][samples] + +## {version} - {Month} {Day}, {Year} + +### Breaking Changes + +### Enhancements + +### Bug Fixes + + +[source_code]: https://... +[package]: https://... +[samples]: https://... +``` + +## Version & Date Format + +- Use the format: `## {version} - {Month} {Day}, {Year}` +- Use the full month name, never abbreviations. +- Examples: + - `## 7.0.0 - November 21, 2023` + - `## 2.4.0 - February 17, 2026` + - `## v1.5.0 - February 14, 2026` (Go uses the `v` prefix) + - `## 8.6.0-preview - February 26, 2026` (preview/beta versions) +- Sort entries in **reverse chronological order** (newest first). + +## Categories + +Organize changes under these headings. Omit a category if it has no entries for that release. + +### Breaking Changes +Reserved for changes that require customers to modify their code or configuration. + +- **Always explain why** the breaking change was made. +- **Always explain how to migrate** from the old behavior to the new one. +- Example: + > Removed `IConfigurationRefresher.SetDirty` API in favor of `IConfigurationRefresher.ProcessPushNotification` API for push-model based configuration refresh. Unlike the SetDirty method, the ProcessPushNotification method guarantees that all configuration changes up to the triggering event are loaded in the following configuration refresh. For more details on the ProcessPushNotification API, refer to [this tutorial](https://link). + +### Enhancements +New features, capabilities, or improvements. + +- Describe **what new scenarios are enabled** and how to take advantage of them. +- Don't just name a new API — explain what it lets customers do. +- Include brief code snippets when they help illustrate usage. +- Example: + > Added health check integration for `Microsoft.Extensions.Diagnostic.HealthChecks`. You can call `AddAzureAppConfiguration` on `IHealthCheckBuilder` to register a health check for the Azure App Configuration provider. [#644](https://github.com/Azure/AppConfiguration-DotnetProvider/pull/644) + > + > ```cs + > builder.Services + > .AddHealthChecks() + > .AddAzureAppConfiguration(); + > ``` + +### Bug Fixes +Fixes for issues customers may have encountered. + +- **Describe the symptom**, not the implementation fix. Customers need to know if the bug affected them. +- Bad: "Added a call to `ConfigureAwait(false)` in `LoadKeyValuesRegisteredForRefresh`" +- Good: "Fixed a bug where ASP.NET Framework applications may fail to refresh their configuration." +- Example: + > Fixed a bug where calls to `FeatureFlagOptions.Select` were ignored if they were followed by a call to either `AzureAppConfigurationOptions.Select` or `AzureAppConfigurationOptions.SelectSnapshot`. [#628](https://github.com/Azure/AppConfiguration-DotnetProvider/issues/628) + +## Linking to Issues and PRs + +- **Always link** each change to a GitHub issue or PR. +- **Prefer linking to issues** over PRs — issues provide more context and already link to the PR. +- Use the format: `[#123](https://github.com/org/repo/issues/123)` +- Place the link at the end of the bullet point. +- Example: + > Added the following new API for additional App Configuration geo-replication support. [#385](https://github.com/Azure/AppConfiguration-DotnetProvider/issues/385) + +## Writing Style + +- Use **past tense**: "Added support for…", "Fixed a bug where…", "Removed the API…" +- Write from the **customer's perspective**, not the developer's. +- Be concise but informative — one to two sentences per entry is typical. + +## What to Exclude + +Do not include changes that are not meaningful to customers: + +- Internal code refactoring +- Telemetry additions or changes +- Test improvements +- CI/CD pipeline changes +- Dependency bumps that don't affect customer behavior (unless they fix a customer-facing issue) + +## Special Cases + +### Preview / Beta Releases +- Include preview and beta versions in the same file, interleaved chronologically. +- Use the full version string: `## 8.6.0-preview - February 26, 2026` +- If a preview release contains the same changes as a prior preview plus a new stable release, note that: "This release includes all preview functionality introduced in X and also adds the changes introduced in Y." + +### Delisted Releases +- Mark delisted versions in the heading: `## 4.2.1 - July 9, 2025 (Delisted)` +- Explain why the release was delisted and link to the tracking issue. + +### Stable Releases That Graduate Preview Features +- Note which features are graduating from preview: "This is the first stable release of the `SetClientFactory` API introduced in 8.2.0-preview." + +## Product Reference + +Use this table to determine the correct release notes file, GitHub repo (for issue/PR links), and package registry for each product. This information is also available in the [main README](../../README.md). + +### Configuration Providers + +| Release Notes File | Module | GitHub Repo | Package | +|---|---|---|---| +| `MicrosoftExtensionsConfigurationAzureAppConfiguration.md` | Microsoft.Extensions.Configuration.AzureAppConfiguration | [Azure/AppConfiguration-DotnetProvider](https://github.com/Azure/AppConfiguration-DotnetProvider) | [NuGet](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.AzureAppConfiguration/) | +| `MicrosoftAzureAppConfigurationAspNetCore.md` | Microsoft.Azure.AppConfiguration.AspNetCore | [Azure/AppConfiguration-DotnetProvider](https://github.com/Azure/AppConfiguration-DotnetProvider) | [NuGet](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore/) | +| `MicrosoftAzureAppConfigurationFunctionsWorker.md` | Microsoft.Azure.AppConfiguration.Functions.Worker | [Azure/AppConfiguration-DotnetProvider](https://github.com/Azure/AppConfiguration-DotnetProvider) | [NuGet](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.Functions.Worker/) | +| `SpringCloudAzureAppConfigurationConfig.md` | spring-cloud-azure-appconfiguration-config | [Azure/azure-sdk-for-java](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-appconfiguration-config) | [Maven](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-appconfiguration-config) | +| `AzureAppConfigurationProviderPython.md` | azure-appconfiguration-provider | [Azure/azure-sdk-for-python](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/appconfiguration/azure-appconfiguration-provider) | [PyPI](https://pypi.org/project/azure-appconfiguration-provider/) | +| `JavaScriptProvider.md` | @azure/app-configuration-provider | [Azure/AppConfiguration-JavaScriptProvider](https://github.com/Azure/AppConfiguration-JavaScriptProvider) | [npm](https://www.npmjs.com/package/@azure/app-configuration-provider) | +| `GoProvider.md` | azureappconfiguration | [Azure/AppConfiguration-GoProvider](https://github.com/Azure/AppConfiguration-GoProvider) | [pkg.go.dev](https://pkg.go.dev/github.com/Azure/AppConfiguration-GoProvider/azureappconfiguration) | + +### Feature Management Libraries + +| Release Notes File | Module | GitHub Repo | Package | +|---|---|---|---| +| `Microsoft.Featuremanagement.md` | Microsoft.FeatureManagement | [microsoft/FeatureManagement-Dotnet](https://github.com/microsoft/FeatureManagement-Dotnet) | [NuGet](https://www.nuget.org/packages/Microsoft.FeatureManagement) | +| `Microsoft.Featuremanagement.AspNetCore.md` | Microsoft.FeatureManagement.AspNetCore | [microsoft/FeatureManagement-Dotnet](https://github.com/microsoft/FeatureManagement-Dotnet) | [NuGet](https://www.nuget.org/packages/Microsoft.FeatureManagement.AspNetCore) | +| `Microsoft.Featuremanagement.Telemetry.ApplicationInsights.md` | Microsoft.FeatureManagement.Telemetry.ApplicationInsights | [microsoft/FeatureManagement-Dotnet](https://github.com/microsoft/FeatureManagement-Dotnet) | [NuGet](https://www.nuget.org/packages/Microsoft.FeatureManagement.Telemetry.ApplicationInsights) | +| `Microsoft.Featuremanagement.Telemetry.ApplicationInsights.AspNetCore.md` | Microsoft.FeatureManagement.Telemetry.ApplicationInsights.AspNetCore | [microsoft/FeatureManagement-Dotnet](https://github.com/microsoft/FeatureManagement-Dotnet) | [NuGet](https://www.nuget.org/packages/Microsoft.FeatureManagement.Telemetry.ApplicationInsights.AspNetCore) | +| `SpringCloudAzureFeatureManagement.md` | spring-cloud-azure-feature-management | [Azure/azure-sdk-for-java](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/spring/spring-cloud-azure-feature-management) | [Maven](https://search.maven.org/artifact/com.azure.spring/spring-cloud-azure-feature-management) | +| `PythonFeatureManagement.md` | featuremanagement | [microsoft/FeatureManagement-Python](https://github.com/microsoft/FeatureManagement-Python) | [PyPI](https://pypi.org/project/FeatureManagement/) | +| `JavaScriptFeatureManagement.md` | @microsoft/feature-management | [microsoft/FeatureManagement-JavaScript](https://github.com/microsoft/FeatureManagement-JavaScript) | [npm](https://www.npmjs.com/package/@microsoft/feature-management) | +| `JavaScriptFeatureManagementApplicationInsightsBrowser.md` | @microsoft/feature-management-applicationinsights-browser | [microsoft/FeatureManagement-JavaScript](https://github.com/microsoft/FeatureManagement-JavaScript) | [npm](https://www.npmjs.com/package/@microsoft/feature-management-applicationinsights-browser) | +| `JavaScriptFeatureManagementApplicationInsightsNode.md` | @microsoft/feature-management-applicationinsights-node | [microsoft/FeatureManagement-JavaScript](https://github.com/microsoft/FeatureManagement-JavaScript) | [npm](https://www.npmjs.com/package/@microsoft/feature-management-applicationinsights-node) | +| `GoFeatureManagement.md` | featuremanagement | [microsoft/FeatureManagement-Go](https://github.com/microsoft/FeatureManagement-Go) | [pkg.go.dev](https://pkg.go.dev/github.com/microsoft/Featuremanagement-Go/featuremanagement) | + +### Platform & Tools + +| Release Notes File | Module | GitHub Repo | Package | +|---|---|---|---| +| `KubernetesProvider.md` | Azure App Configuration Kubernetes Provider | [Azure/AppConfiguration-KubernetesProvider](https://github.com/Azure/AppConfiguration-KubernetesProvider) | [MCR](https://mcr.microsoft.com/en-us/product/azure-app-configuration/kubernetes-provider/about) | +| `AppConfigurationEmulator.md` | Azure App Configuration Emulator | [Azure/AppConfiguration-Emulator](https://github.com/Azure/AppConfiguration-Emulator) | — | +| `AzureDevOpsPipelineExtension.md` | Azure App Configuration (Azure Pipeline) | — | — | +| `AzureDevOpsPushPipelineExtension.md` | Azure App Configuration Push (Azure Pipeline) | — | — | + +### Legacy (Deprecated) + +| Release Notes File | Module | GitHub Repo | +|---|---|---| +| `AzureSpringCloudAppConfigurationConfig.md` | azure-spring-cloud-appconfiguration-config | [Azure/azure-sdk-for-java](https://github.com/Azure/azure-sdk-for-java) | +| `AzureSpringCloudFeatureManagement.md` | azure-spring-cloud-feature-management | [Azure/azure-sdk-for-java](https://github.com/Azure/azure-sdk-for-java) | diff --git a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md index 5b70ac5e..9931436c 100644 --- a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md +++ b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md @@ -14,6 +14,16 @@ [Source code][source_code_web] | [Package (Maven)][package_web] +## 6.0.0 - September 22, 2025 + +This is the first stable release of the 6.0.0 major version, which includes all changes introduced in 6.0.0-beta.1. + +### Breaking Changes + +* Replaced `bootstrap.properties` and `bootstrap.yml` configuration with the standard Spring configuration system using `application.properties` and `application.yml`. Applications must now set `spring.config.import=azureAppConfiguration` to load Azure App Configuration. +* Changed the default authentication method from `ManagedIdentityCredential` to `DefaultAzureCredential`. Applications that previously relied on `ManagedIdentityCredential` should verify their authentication configuration is compatible with `DefaultAzureCredential`. +* Removed the `fail-fast` property. Replicas should be used to ensure high availability. + ## 6.0.0-beta.1 - June 04, 2025 ### Enhancements diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index 5f12bd8a..afbf5c5e 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -8,6 +8,20 @@ [Source code][source_code_web] | [Package (Maven)][package_web] +## 6.0.0 - September 22, 2025 + +This is the first stable release of the 6.0.0 major version, which includes all changes introduced in 6.0.0-beta.1. + +### Breaking Changes + +* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. + +### Enhancements + +* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). +* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. +* Added built-in Feature Filters that are now created by default if no filters are provided. + ## 6.0.0-beta.1 - June 04, 2025 ### Breaking Changes From 8845b75aa9237c5da5bcb15da0d9524b9c461059 Mon Sep 17 00:00:00 2001 From: Matthew Metcalf Date: Tue, 17 Mar 2026 14:01:21 -0700 Subject: [PATCH 2/6] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .github/copilot-instructions.md | 4 ++-- .github/skills/release-notes/SKILL.md | 2 +- releaseNotes/SpringCloudAzureFeatureManagement.md | 12 ++++++------ 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index a6c45bdd..673794d2 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -25,8 +25,8 @@ This is **not** a library repo — it is a reference and documentation repositor ### Python - **Black** formatter: line-length=120, target Python 3.8+ - **Pylint**: max-line-length=120 -- **MyPy**: type checking enabled -- Run formatting/linting via tox tasks defined in the workspace +- **MyPy**: type checking is recommended; use where configured in individual examples +- Run formatting and linting directly via these tools (or any per-example tooling); no shared tox tasks are defined at the repo root ### All Languages - Each example must be self-contained with its own README, dependencies, and setup instructions diff --git a/.github/skills/release-notes/SKILL.md b/.github/skills/release-notes/SKILL.md index fd48d9cf..3901633e 100644 --- a/.github/skills/release-notes/SKILL.md +++ b/.github/skills/release-notes/SKILL.md @@ -128,7 +128,7 @@ Do not include changes that are not meaningful to customers: ## Product Reference -Use this table to determine the correct release notes file, GitHub repo (for issue/PR links), and package registry for each product. This information is also available in the [main README](../../README.md). +Use this table to determine the correct release notes file, GitHub repo (for issue/PR links), and package registry for each product. This information is also available in the [main README](../../../README.md). ### Configuration Providers diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index afbf5c5e..354367ac 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -18,9 +18,9 @@ This is the first stable release of the 6.0.0 major version, which includes all ### Enhancements -* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). -* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. -* Added built-in Feature Filters that are now created by default if no filters are provided. +* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) +* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. [#29691](https://github.com/Azure/azure-sdk-for-java/issues/29691) +* Added built-in Feature Filters that are now created by default if no filters are provided. [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) ## 6.0.0-beta.1 - June 04, 2025 @@ -30,9 +30,9 @@ This is the first stable release of the 6.0.0 major version, which includes all ### Enhancements -* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). -* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. -* Added built-in Feature Filters that are now created by default if no filters are provided. +* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) +* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. [#29691](https://github.com/Azure/azure-sdk-for-java/issues/29691) +* Added built-in Feature Filters that are now created by default if no filters are provided. [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) ## 5.16.0 - September 09, 2024 From 2c1671e2657f0d6ba8716a04ecf54c7684af0016 Mon Sep 17 00:00:00 2001 From: Matt Metcalf Date: Tue, 17 Mar 2026 14:04:02 -0700 Subject: [PATCH 3/6] fix skill --- .github/skills/release-notes/SKILL.md | 4 +++- releaseNotes/SpringCloudAzureAppConfigurationConfig.md | 2 -- releaseNotes/SpringCloudAzureFeatureManagement.md | 2 -- 3 files changed, 3 insertions(+), 5 deletions(-) diff --git a/.github/skills/release-notes/SKILL.md b/.github/skills/release-notes/SKILL.md index 3901633e..649bc42f 100644 --- a/.github/skills/release-notes/SKILL.md +++ b/.github/skills/release-notes/SKILL.md @@ -117,7 +117,9 @@ Do not include changes that are not meaningful to customers: ### Preview / Beta Releases - Include preview and beta versions in the same file, interleaved chronologically. - Use the full version string: `## 8.6.0-preview - February 26, 2026` -- If a preview release contains the same changes as a prior preview plus a new stable release, note that: "This release includes all preview functionality introduced in X and also adds the changes introduced in Y." +- Preview/beta releases are **cumulative** — each one includes all changes from previous previews in that series. List all changes in every preview entry; duplicates across preview entries are expected. +- The first stable release also re-lists all changes that were introduced across its preview/beta cycle. Do not omit items just because they appeared in a prior preview. + ### Delisted Releases - Mark delisted versions in the heading: `## 4.2.1 - July 9, 2025 (Delisted)` diff --git a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md index 9931436c..40cd1a7f 100644 --- a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md +++ b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md @@ -16,8 +16,6 @@ ## 6.0.0 - September 22, 2025 -This is the first stable release of the 6.0.0 major version, which includes all changes introduced in 6.0.0-beta.1. - ### Breaking Changes * Replaced `bootstrap.properties` and `bootstrap.yml` configuration with the standard Spring configuration system using `application.properties` and `application.yml`. Applications must now set `spring.config.import=azureAppConfiguration` to load Azure App Configuration. diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index 354367ac..3e72925c 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -10,8 +10,6 @@ ## 6.0.0 - September 22, 2025 -This is the first stable release of the 6.0.0 major version, which includes all changes introduced in 6.0.0-beta.1. - ### Breaking Changes * Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. From 9fc417dbf72690248c27548e68e59ec3580c096d Mon Sep 17 00:00:00 2001 From: Matt Metcalf Date: Tue, 17 Mar 2026 14:06:17 -0700 Subject: [PATCH 4/6] added links --- .../SpringCloudAzureAppConfigurationConfig.md | 12 ++++++------ releaseNotes/SpringCloudAzureFeatureManagement.md | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md index 40cd1a7f..ac1a4b08 100644 --- a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md +++ b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md @@ -18,18 +18,18 @@ ### Breaking Changes -* Replaced `bootstrap.properties` and `bootstrap.yml` configuration with the standard Spring configuration system using `application.properties` and `application.yml`. Applications must now set `spring.config.import=azureAppConfiguration` to load Azure App Configuration. -* Changed the default authentication method from `ManagedIdentityCredential` to `DefaultAzureCredential`. Applications that previously relied on `ManagedIdentityCredential` should verify their authentication configuration is compatible with `DefaultAzureCredential`. -* Removed the `fail-fast` property. Replicas should be used to ensure high availability. +* Replaced `bootstrap.properties` and `bootstrap.yml` configuration with the standard Spring configuration system using `application.properties` and `application.yml`. Applications must now set `spring.config.import=azureAppConfiguration` to load Azure App Configuration. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Changed the default authentication method from `ManagedIdentityCredential` to `DefaultAzureCredential`. Applications that previously relied on `ManagedIdentityCredential` should verify their authentication configuration is compatible with `DefaultAzureCredential`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Removed the `fail-fast` property. Replicas should be used to ensure high availability. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) ## 6.0.0-beta.1 - June 04, 2025 ### Enhancements -* Added support for new Spring configuration system. Now uses `application.properties` and `application.yml` files instead of `bootstrap.properties` and `bootstrap.yml`. +* Added support for new Spring configuration system. Now uses `application.properties` and `application.yml` files instead of `bootstrap.properties` and `bootstrap.yml`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) * Now requires `spring.config.import=azureAppConfiguration` to be set to load Azure App Configuration. -* Added `DefaultAzureCredential` as the default authentication method instead of `ManagedIdentityCredential`. -* Removed `fail-fast` property. Replicas should be used to ensure high availability. +* Added `DefaultAzureCredential` as the default authentication method instead of `ManagedIdentityCredential`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Removed `fail-fast` property. Replicas should be used to ensure high availability. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) ## 5.16.0 - September 09, 2024 diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index 3e72925c..21031959 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -12,7 +12,7 @@ ### Breaking Changes -* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. +* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) ### Enhancements @@ -24,7 +24,7 @@ ### Breaking Changes -* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. +* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) ### Enhancements From ac2cb83e8f5c20f60929ec9e0c4a8fcab753b488 Mon Sep 17 00:00:00 2001 From: Matt Metcalf Date: Tue, 17 Mar 2026 15:18:15 -0700 Subject: [PATCH 5/6] remove release notes --- .../SpringCloudAzureAppConfigurationConfig.md | 8 -------- releaseNotes/SpringCloudAzureFeatureManagement.md | 12 ------------ 2 files changed, 20 deletions(-) diff --git a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md index ac1a4b08..180a32f4 100644 --- a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md +++ b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md @@ -14,14 +14,6 @@ [Source code][source_code_web] | [Package (Maven)][package_web] -## 6.0.0 - September 22, 2025 - -### Breaking Changes - -* Replaced `bootstrap.properties` and `bootstrap.yml` configuration with the standard Spring configuration system using `application.properties` and `application.yml`. Applications must now set `spring.config.import=azureAppConfiguration` to load Azure App Configuration. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) -* Changed the default authentication method from `ManagedIdentityCredential` to `DefaultAzureCredential`. Applications that previously relied on `ManagedIdentityCredential` should verify their authentication configuration is compatible with `DefaultAzureCredential`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) -* Removed the `fail-fast` property. Replicas should be used to ensure high availability. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) - ## 6.0.0-beta.1 - June 04, 2025 ### Enhancements diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index 21031959..4873b100 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -8,18 +8,6 @@ [Source code][source_code_web] | [Package (Maven)][package_web] -## 6.0.0 - September 22, 2025 - -### Breaking Changes - -* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) - -### Enhancements - -* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) -* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. [#29691](https://github.com/Azure/azure-sdk-for-java/issues/29691) -* Added built-in Feature Filters that are now created by default if no filters are provided. [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) - ## 6.0.0-beta.1 - June 04, 2025 ### Breaking Changes From a4ad825c4141733db56310eef9819a18a34c7714 Mon Sep 17 00:00:00 2001 From: Matt Metcalf Date: Tue, 17 Mar 2026 15:57:18 -0700 Subject: [PATCH 6/6] remove links --- releaseNotes/SpringCloudAzureAppConfigurationConfig.md | 6 +++--- releaseNotes/SpringCloudAzureFeatureManagement.md | 8 ++++---- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md index 180a32f4..5b70ac5e 100644 --- a/releaseNotes/SpringCloudAzureAppConfigurationConfig.md +++ b/releaseNotes/SpringCloudAzureAppConfigurationConfig.md @@ -18,10 +18,10 @@ ### Enhancements -* Added support for new Spring configuration system. Now uses `application.properties` and `application.yml` files instead of `bootstrap.properties` and `bootstrap.yml`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Added support for new Spring configuration system. Now uses `application.properties` and `application.yml` files instead of `bootstrap.properties` and `bootstrap.yml`. * Now requires `spring.config.import=azureAppConfiguration` to be set to load Azure App Configuration. -* Added `DefaultAzureCredential` as the default authentication method instead of `ManagedIdentityCredential`. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) -* Removed `fail-fast` property. Replicas should be used to ensure high availability. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Added `DefaultAzureCredential` as the default authentication method instead of `ManagedIdentityCredential`. +* Removed `fail-fast` property. Replicas should be used to ensure high availability. ## 5.16.0 - September 09, 2024 diff --git a/releaseNotes/SpringCloudAzureFeatureManagement.md b/releaseNotes/SpringCloudAzureFeatureManagement.md index 4873b100..5f12bd8a 100644 --- a/releaseNotes/SpringCloudAzureFeatureManagement.md +++ b/releaseNotes/SpringCloudAzureFeatureManagement.md @@ -12,13 +12,13 @@ ### Breaking Changes -* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. [#45222](https://github.com/Azure/azure-sdk-for-java/pull/45222) +* Changed the method for calculating the `TargetingFilter` to match the results for the other Feature Management libraries. This will result in different results for percentage rollouts. ### Enhancements -* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) -* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. [#29691](https://github.com/Azure/azure-sdk-for-java/issues/29691) -* Added built-in Feature Filters that are now created by default if no filters are provided. [#38293](https://github.com/Azure/azure-sdk-for-java/pull/38293) +* Added support for Feature Variants. A new method has been added to `FeatureManager` that allows you to retrieve the `Variant` of a feature flag. See the [Variants documentation](https://learn.microsoft.com/azure/azure-app-configuration/howto-variant-feature-flags). +* Added support for providing local context to feature filters. All `FeatureManager` methods now have an overload that accepts a feature context which is an `Object`. This context is passed to the feature filters and can be used to provide additional information to the filters. +* Added built-in Feature Filters that are now created by default if no filters are provided. ## 5.16.0 - September 09, 2024