diff --git a/.github/prompts/release-notes.prompt.md b/.github/prompts/release-notes.prompt.md new file mode 100644 index 0000000000..b2079143b8 --- /dev/null +++ b/.github/prompts/release-notes.prompt.md @@ -0,0 +1,28 @@ +--- +name: release-notes +description: Generate release notes for a specific milestone of the Microsoft.Data.SqlClient project. +argument-hint: +agent: agent +tools: ['github/search_issues', 'createFile', 'editFiles', 'readFile'] +--- + +Generate release notes for the milestone "${input:milestone}". + +Steps: +1. Fetch Milestone Items + - Search for all **merged** Pull Requests associated with the milestone "${input:milestone}" in the `dotnet/SqlClient` repository. + - Use `github/search_issues` with query `is:pr is:merged milestone:"${input:milestone}" repo:dotnet/SqlClient`. +2. Analyze and Categorize + - Review the title and body of each PR. + - Categorize them into: `Added`, `Fixed`, `Changed`, `Removed`. + - Identify the contributors for the "Contributors" section. +3. Create Release Notes File + - Determine the correct path: `release-notes//.md`. + - Create the file with the template contents from `release-notes/template/release-notes-template.md`. + - Fill in the template, following the instructions present in each section. +4. Update CHANGELOG.md + - Add a new entry at the top of the list (under the Note). + - Include all the text from the Added, Fixed, Changed, Removed, etc. sections from the release notes. +5. Update Release Directory README + - Update `release-notes//README.md`. + - Add the new release to the table: `| | | [Release Notes](.md) |`. diff --git a/CHANGELOG.md b/CHANGELOG.md index 8bdde30782..c3914ef365 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,81 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) > **Note:** Releases are sorted in reverse chronological order (newest first). +## [Preview Release 7.0.0-preview3.25342.7] - 2025-12-08 + +This update brings the following changes over the previous preview release: + +### Added + +#### Support for .NET 10 + +*What Changed:* + +- Updated pipelines and test suites to compile the driver using the .NET 10 SDK. Cleaned up unnecessary dependency references. + ([#3686](https://github.com/dotnet/SqlClient/pull/3686)) + +*Who Benefits:* + +- Developers targeting .NET 10. + +*Impact:* + +- Addressed .NET 10 warnings regarding unused/unnecessary dependencies. + +#### Enable SqlClientDiagnosticListener in SqlCommand on .NET Framework + +*What Changed:* + +- Enabled SqlClientDiagnosticListener functionality on SqlCommand for .NET Framework. + ([#3658](https://github.com/dotnet/SqlClient/pull/3658)) + +*Who Benefits:* + +- Developers requiring diagnostic information on .NET Framework. + +*Impact:* + +- Improved observability and diagnostics for SqlCommand on .NET Framework. + +#### Enable User Agent Extension + +*What Changed:* + +- Enabled User Agent Feature Extension. + ([#3606](https://github.com/dotnet/SqlClient/pull/3606)) + +*Who Benefits:* + +- Telemetry and diagnostics consumers. + +*Impact:* + +- When the `Switch.Microsoft.Data.SqlClient.EnableUserAgent` app context switch is enabled, the driver sends more detailed user agent strings. This switch is disabled by default. This change will assist with troubleshooting and quantifying driver usage by version and operating system. + +### Fixed + +- Fixed an issue where extra connection deactivation was occurring. + ([#3758](https://github.com/dotnet/SqlClient/pull/3758)) + +### Changed + +#### Other changes + +- Performance improvements: + ([#3732](https://github.com/dotnet/SqlClient/pull/3732), + [#3660](https://github.com/dotnet/SqlClient/pull/3660)) + +- Codebase merge and cleanup: + ([#3803](https://github.com/dotnet/SqlClient/pull/3803), + [#3781](https://github.com/dotnet/SqlClient/pull/3781), + [#3760](https://github.com/dotnet/SqlClient/pull/3760), + [#3746](https://github.com/dotnet/SqlClient/pull/3746), + [#3743](https://github.com/dotnet/SqlClient/pull/3743), + [#3738](https://github.com/dotnet/SqlClient/pull/3738), + [#3683](https://github.com/dotnet/SqlClient/pull/3683), + [#3676](https://github.com/dotnet/SqlClient/pull/3676), + [#3768](https://github.com/dotnet/SqlClient/pull/3768)) + ## [Stable release 6.0.4] - 2025-11-15 This update brings the below changes over the previous stable release: diff --git a/release-notes/7.0/7.0.0-preview3.md b/release-notes/7.0/7.0.0-preview3.md new file mode 100644 index 0000000000..7af6c2c3d0 --- /dev/null +++ b/release-notes/7.0/7.0.0-preview3.md @@ -0,0 +1,146 @@ +# Release Notes + +## Preview Release 7.0.0-preview3.25342.7 - December 8, 2025 + +### Added + +#### Support for .NET 10 + +*What Changed:* + +- Updated pipelines and test suites to compile the driver using the .NET 10 SDK. Cleaned up unnecessary dependency references. + ([#3686](https://github.com/dotnet/SqlClient/pull/3686)) + +*Who Benefits:* + +- Developers targeting .NET 10. + +*Impact:* + +- Addressed .NET 10 warnings regarding unused/unnecessary dependencies. + +#### Enable SqlClientDiagnosticListener in SqlCommand on .NET Framework + +*What Changed:* + +- Enabled SqlClientDiagnosticListener functionality on SqlCommand for .NET Framework. + ([#3658](https://github.com/dotnet/SqlClient/pull/3658)) + +*Who Benefits:* + +- Developers requiring diagnostic information on .NET Framework. + +*Impact:* + +- Improved observability and diagnostics for SqlCommand on .NET Framework. + +#### Enable User Agent Extension + +*What Changed:* + +- Enabled User Agent Feature Extension. + ([#3606](https://github.com/dotnet/SqlClient/pull/3606)) + +*Who Benefits:* + +- Telemetry and diagnostics consumers. + +*Impact:* + +- When the `Switch.Microsoft.Data.SqlClient.EnableUserAgent` app context switch is enabled, the driver sends more detailed user agent strings. This switch is disabled by default. This change will assist with troubleshooting and quantifying driver usage by version and operating system. + +### Fixed + +- Fixed an issue where extra connection deactivation was occurring. + ([#3758](https://github.com/dotnet/SqlClient/pull/3758)) + +### Changed + +#### Other changes + +- Performance improvements: + ([#3732](https://github.com/dotnet/SqlClient/pull/3732), + [#3660](https://github.com/dotnet/SqlClient/pull/3660)) + +- Codebase merge and cleanup: + ([#3803](https://github.com/dotnet/SqlClient/pull/3803), + [#3781](https://github.com/dotnet/SqlClient/pull/3781), + [#3760](https://github.com/dotnet/SqlClient/pull/3760), + [#3746](https://github.com/dotnet/SqlClient/pull/3746), + [#3743](https://github.com/dotnet/SqlClient/pull/3743), + [#3738](https://github.com/dotnet/SqlClient/pull/3738), + [#3683](https://github.com/dotnet/SqlClient/pull/3683), + [#3676](https://github.com/dotnet/SqlClient/pull/3676), + [#3768](https://github.com/dotnet/SqlClient/pull/3768)) + +## Contributors + +We thank the following public contributors. Their efforts toward this project are very much appreciated. + +- [edwardneal](https://github.com/edwardneal) + +## Target Platform Support + +- .NET Framework 4.6.2+ (Windows x86, Windows x64, Windows ARM64) +- .NET 8.0+ (Windows x86, Windows x64, Windows ARM, Windows ARM64, Linux, macOS) + +### Dependencies + +#### .NET 9.0 + +- Azure.Core 1.49.0 +- Azure.Identity 1.16.0 +- Microsoft.Bcl.Cryptography 9.0.9 +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 +- Microsoft.Extensions.Caching.Memory 9.0.9 +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 +- Microsoft.SqlServer.Server 1.0.0 +- System.Configuration.ConfigurationManager 9.0.9 +- System.Security.Cryptography.Pkcs 9.0.9 + +#### .NET 8.0 + +- Azure.Core 1.49.0 +- Azure.Identity 1.16.0 +- Microsoft.Bcl.Cryptography 8.0.0 +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 +- Microsoft.Extensions.Caching.Memory 8.0.1 +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 +- Microsoft.SqlServer.Server 1.0.0 +- System.Configuration.ConfigurationManager 8.0.1 +- System.Security.Cryptography.Pkcs 8.0.1 + +#### .NET Standard 2.0 + +- Azure.Core 1.49.0 +- Azure.Identity 1.16.0 +- Microsoft.Bcl.Cryptography 8.0.0 +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 +- Microsoft.Extensions.Caching.Memory 8.0.1 +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 +- Microsoft.SqlServer.Server 1.0.0 +- System.Configuration.ConfigurationManager 8.0.1 +- System.Security.Cryptography.Pkcs 8.0.1 +- System.Text.Json 8.0.6 +- System.Threading.Channels 8.0.0 + +#### .NET Framework 4.6.2 + +- Azure.Core 1.49.0 +- Azure.Identity 1.16.0 +- Microsoft.Bcl.Cryptography 8.0.0 +- Microsoft.Data.SqlClient.SNI 6.0.2 +- Microsoft.Extensions.Caching.Memory 8.0.1 +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 +- System.Buffers 4.6.1 +- System.Diagnostics.DiagnosticSource 8.0.1 +- System.Memory 4.6.3 +- System.Runtime.InteropServices.RuntimeInformation 4.3.0 +- System.Security.Cryptography.Pkcs 8.0.1 +- System.Text.Json 8.0.6 +- System.Threading.Channels 8.0.0 +- System.ValueTuple 4.6.1 diff --git a/release-notes/7.0/README.md b/release-notes/7.0/README.md index e660d7bdde..1aad450b03 100644 --- a/release-notes/7.0/README.md +++ b/release-notes/7.0/README.md @@ -4,6 +4,7 @@ The following Microsoft.Data.SqlClient 7.0 releases have been shipped: | Release Date | Version | Notes | | :-- | :-- | :--: | +| 2025-12-08 | 7.0.0-preview3.25342.7 | [Release Notes](7.0.0-preview3.md) | | 2025-10-16 | 7.0.0-preview2.25289.6 | [Release Notes](7.0.0-preview2.md) | | 2025-09-12 | 7.0.0-preview1.25257.1 | [Release Notes](7.0.0-preview1.md) | diff --git a/release-notes/template/release-notes-template.md b/release-notes/template/release-notes-template.md new file mode 100644 index 0000000000..d194d95f8e --- /dev/null +++ b/release-notes/template/release-notes-template.md @@ -0,0 +1,92 @@ +# Release Notes + +## [Release Type] [Version] - [Release Date] + +### Changed + +#### [Breaking Change or Major Change Title] + +*What Changed:* + +- [Detailed description of what changed, including deprecation/obsolete notices and PR reference] + +*Who Benefits:* + +- [Description of who benefits and why this change is being made] + +*Impact:* + +- [Migration guidance] + - [Alternative option 1] + - [Alternative option 2] + - [Alternative option 3] +- [Links to documentation] + +#### Other changes + +- [Description of change] + ([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM)) + +- [Category of changes] (e.g., Various test improvements, Codebase merge, Code health improvements, Internal infrastructure improvements): + ([#PRNUM1](https://github.com/dotnet/SqlClient/pull/PRNUM1), + [#PRNUM2](https://github.com/dotnet/SqlClient/pull/PRNUM2), + [#PRNUM3](https://github.com/dotnet/SqlClient/pull/PRNUM3)) + +- Updated Dependencies + ([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM)): + - Updated `PackageName` to vX.Y.Z + - Updated `PackageName` to vX.Y.Z (target framework if applicable) + +### Fixed + +- [Description of bug fix] + ([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM)) + +### Added + +#### [Feature Name] + +*What Changed:* + +- [Detailed description of what changed, including PR reference] + +*Who Benefits:* + +- [Description of who benefits from this change] +- [Additional beneficiaries or use cases] + +*Impact:* + +- [Description of impact and how to use the feature] +- [Code example if applicable] + +```c# +// Code example +``` + +- [Additional impact notes or migration guidance] + +#### Other Additions + +- [Description of other additions] + ([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM)) + +## Contributors +(Only list public contributors. Do not list core team or bot contributors.) + + +We thank the following public contributors. Their efforts toward this project are very much appreciated. + +- [username](https://github.com/username) + +## Target Platform Support +(Look at target frameworks in the netcore and netfx project files.) + +- [Target Framework Version] ([Supported Operating Systems]) + +### Dependencies +(Use the dependencies listed at tools\specs\Microsoft.Data.SqlClient.nuspec) + +#### [Target Framework Version] + +- [Dependency] [Version] \ No newline at end of file