Skip to content

Commit 6b047ab

Browse files
mdaiglemdaigle
authored
Add 7.0.0-preview3 release notes and release note generation prompt. (#3829)
1 parent c23fed6 commit 6b047ab

File tree

5 files changed

+342
-0
lines changed

5 files changed

+342
-0
lines changed

‎.github/prompts/release-notes.prompt.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
name: release-notes
3+
description: Generate release notes for a specific milestone of the Microsoft.Data.SqlClient project.
4+
argument-hint: <milestone>
5+
agent: agent
6+
tools: ['github/search_issues', 'createFile', 'editFiles', 'readFile']
7+
---
8+
9+
Generate release notes for the milestone "${input:milestone}".
10+
11+
Steps:
12+
1. Fetch Milestone Items
13+
- Search for all **merged** Pull Requests associated with the milestone "${input:milestone}" in the `dotnet/SqlClient` repository.
14+
- Use `github/search_issues` with query `is:pr is:merged milestone:"${input:milestone}" repo:dotnet/SqlClient`.
15+
2. Analyze and Categorize
16+
- Review the title and body of each PR.
17+
- Categorize them into: `Added`, `Fixed`, `Changed`, `Removed`.
18+
- Identify the contributors for the "Contributors" section.
19+
3. Create Release Notes File
20+
- Determine the correct path: `release-notes/<Major.Minor>/<Version>.md`.
21+
- Create the file with the template contents from `release-notes/template/release-notes-template.md`.
22+
- Fill in the template, following the instructions present in each section.
23+
4. Update CHANGELOG.md
24+
- Add a new entry at the top of the list (under the Note).
25+
- Include all the text from the Added, Fixed, Changed, Removed, etc. sections from the release notes.
26+
5. Update Release Directory README
27+
- Update `release-notes/<Major.Minor>/README.md`.
28+
- Add the new release to the table: `| <Date> | <Version> | [Release Notes](<Version>.md) |`.

‎CHANGELOG.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,81 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
77

88
> **Note:** Releases are sorted in reverse chronological order (newest first).
99
10+
## [Preview Release 7.0.0-preview3.25342.7] - 2025-12-08
11+
12+
This update brings the following changes over the previous preview release:
13+
14+
### Added
15+
16+
#### Support for .NET 10
17+
18+
*What Changed:*
19+
20+
- Updated pipelines and test suites to compile the driver using the .NET 10 SDK. Cleaned up unnecessary dependency references.
21+
([#3686](https://github.com/dotnet/SqlClient/pull/3686))
22+
23+
*Who Benefits:*
24+
25+
- Developers targeting .NET 10.
26+
27+
*Impact:*
28+
29+
- Addressed .NET 10 warnings regarding unused/unnecessary dependencies.
30+
31+
#### Enable SqlClientDiagnosticListener in SqlCommand on .NET Framework
32+
33+
*What Changed:*
34+
35+
- Enabled SqlClientDiagnosticListener functionality on SqlCommand for .NET Framework.
36+
([#3658](https://github.com/dotnet/SqlClient/pull/3658))
37+
38+
*Who Benefits:*
39+
40+
- Developers requiring diagnostic information on .NET Framework.
41+
42+
*Impact:*
43+
44+
- Improved observability and diagnostics for SqlCommand on .NET Framework.
45+
46+
#### Enable User Agent Extension
47+
48+
*What Changed:*
49+
50+
- Enabled User Agent Feature Extension.
51+
([#3606](https://github.com/dotnet/SqlClient/pull/3606))
52+
53+
*Who Benefits:*
54+
55+
- Telemetry and diagnostics consumers.
56+
57+
*Impact:*
58+
59+
- 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.
60+
61+
### Fixed
62+
63+
- Fixed an issue where extra connection deactivation was occurring.
64+
([#3758](https://github.com/dotnet/SqlClient/pull/3758))
65+
66+
### Changed
67+
68+
#### Other changes
69+
70+
- Performance improvements:
71+
([#3732](https://github.com/dotnet/SqlClient/pull/3732),
72+
[#3660](https://github.com/dotnet/SqlClient/pull/3660))
73+
74+
- Codebase merge and cleanup:
75+
([#3803](https://github.com/dotnet/SqlClient/pull/3803),
76+
[#3781](https://github.com/dotnet/SqlClient/pull/3781),
77+
[#3760](https://github.com/dotnet/SqlClient/pull/3760),
78+
[#3746](https://github.com/dotnet/SqlClient/pull/3746),
79+
[#3743](https://github.com/dotnet/SqlClient/pull/3743),
80+
[#3738](https://github.com/dotnet/SqlClient/pull/3738),
81+
[#3683](https://github.com/dotnet/SqlClient/pull/3683),
82+
[#3676](https://github.com/dotnet/SqlClient/pull/3676),
83+
[#3768](https://github.com/dotnet/SqlClient/pull/3768))
84+
1085
## [Stable release 6.0.4] - 2025-11-15
1186

1287
This update brings the below changes over the previous stable release:

‎release-notes/7.0/7.0.0-preview3.md‎

Lines changed: 146 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
1+
# Release Notes
2+
3+
## Preview Release 7.0.0-preview3.25342.7 - December 8, 2025
4+
5+
### Added
6+
7+
#### Support for .NET 10
8+
9+
*What Changed:*
10+
11+
- Updated pipelines and test suites to compile the driver using the .NET 10 SDK. Cleaned up unnecessary dependency references.
12+
([#3686](https://github.com/dotnet/SqlClient/pull/3686))
13+
14+
*Who Benefits:*
15+
16+
- Developers targeting .NET 10.
17+
18+
*Impact:*
19+
20+
- Addressed .NET 10 warnings regarding unused/unnecessary dependencies.
21+
22+
#### Enable SqlClientDiagnosticListener in SqlCommand on .NET Framework
23+
24+
*What Changed:*
25+
26+
- Enabled SqlClientDiagnosticListener functionality on SqlCommand for .NET Framework.
27+
([#3658](https://github.com/dotnet/SqlClient/pull/3658))
28+
29+
*Who Benefits:*
30+
31+
- Developers requiring diagnostic information on .NET Framework.
32+
33+
*Impact:*
34+
35+
- Improved observability and diagnostics for SqlCommand on .NET Framework.
36+
37+
#### Enable User Agent Extension
38+
39+
*What Changed:*
40+
41+
- Enabled User Agent Feature Extension.
42+
([#3606](https://github.com/dotnet/SqlClient/pull/3606))
43+
44+
*Who Benefits:*
45+
46+
- Telemetry and diagnostics consumers.
47+
48+
*Impact:*
49+
50+
- 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.
51+
52+
### Fixed
53+
54+
- Fixed an issue where extra connection deactivation was occurring.
55+
([#3758](https://github.com/dotnet/SqlClient/pull/3758))
56+
57+
### Changed
58+
59+
#### Other changes
60+
61+
- Performance improvements:
62+
([#3732](https://github.com/dotnet/SqlClient/pull/3732),
63+
[#3660](https://github.com/dotnet/SqlClient/pull/3660))
64+
65+
- Codebase merge and cleanup:
66+
([#3803](https://github.com/dotnet/SqlClient/pull/3803),
67+
[#3781](https://github.com/dotnet/SqlClient/pull/3781),
68+
[#3760](https://github.com/dotnet/SqlClient/pull/3760),
69+
[#3746](https://github.com/dotnet/SqlClient/pull/3746),
70+
[#3743](https://github.com/dotnet/SqlClient/pull/3743),
71+
[#3738](https://github.com/dotnet/SqlClient/pull/3738),
72+
[#3683](https://github.com/dotnet/SqlClient/pull/3683),
73+
[#3676](https://github.com/dotnet/SqlClient/pull/3676),
74+
[#3768](https://github.com/dotnet/SqlClient/pull/3768))
75+
76+
## Contributors
77+
78+
We thank the following public contributors. Their efforts toward this project are very much appreciated.
79+
80+
- [edwardneal](https://github.com/edwardneal)
81+
82+
## Target Platform Support
83+
84+
- .NET Framework 4.6.2+ (Windows x86, Windows x64, Windows ARM64)
85+
- .NET 8.0+ (Windows x86, Windows x64, Windows ARM, Windows ARM64, Linux, macOS)
86+
87+
### Dependencies
88+
89+
#### .NET 9.0
90+
91+
- Azure.Core 1.49.0
92+
- Azure.Identity 1.16.0
93+
- Microsoft.Bcl.Cryptography 9.0.9
94+
- Microsoft.Data.SqlClient.SNI.runtime 6.0.2
95+
- Microsoft.Extensions.Caching.Memory 9.0.9
96+
- Microsoft.IdentityModel.JsonWebTokens 8.14.0
97+
- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0
98+
- Microsoft.SqlServer.Server 1.0.0
99+
- System.Configuration.ConfigurationManager 9.0.9
100+
- System.Security.Cryptography.Pkcs 9.0.9
101+
102+
#### .NET 8.0
103+
104+
- Azure.Core 1.49.0
105+
- Azure.Identity 1.16.0
106+
- Microsoft.Bcl.Cryptography 8.0.0
107+
- Microsoft.Data.SqlClient.SNI.runtime 6.0.2
108+
- Microsoft.Extensions.Caching.Memory 8.0.1
109+
- Microsoft.IdentityModel.JsonWebTokens 8.14.0
110+
- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0
111+
- Microsoft.SqlServer.Server 1.0.0
112+
- System.Configuration.ConfigurationManager 8.0.1
113+
- System.Security.Cryptography.Pkcs 8.0.1
114+
115+
#### .NET Standard 2.0
116+
117+
- Azure.Core 1.49.0
118+
- Azure.Identity 1.16.0
119+
- Microsoft.Bcl.Cryptography 8.0.0
120+
- Microsoft.Data.SqlClient.SNI.runtime 6.0.2
121+
- Microsoft.Extensions.Caching.Memory 8.0.1
122+
- Microsoft.IdentityModel.JsonWebTokens 8.14.0
123+
- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0
124+
- Microsoft.SqlServer.Server 1.0.0
125+
- System.Configuration.ConfigurationManager 8.0.1
126+
- System.Security.Cryptography.Pkcs 8.0.1
127+
- System.Text.Json 8.0.6
128+
- System.Threading.Channels 8.0.0
129+
130+
#### .NET Framework 4.6.2
131+
132+
- Azure.Core 1.49.0
133+
- Azure.Identity 1.16.0
134+
- Microsoft.Bcl.Cryptography 8.0.0
135+
- Microsoft.Data.SqlClient.SNI 6.0.2
136+
- Microsoft.Extensions.Caching.Memory 8.0.1
137+
- Microsoft.IdentityModel.JsonWebTokens 8.14.0
138+
- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0
139+
- System.Buffers 4.6.1
140+
- System.Diagnostics.DiagnosticSource 8.0.1
141+
- System.Memory 4.6.3
142+
- System.Runtime.InteropServices.RuntimeInformation 4.3.0
143+
- System.Security.Cryptography.Pkcs 8.0.1
144+
- System.Text.Json 8.0.6
145+
- System.Threading.Channels 8.0.0
146+
- System.ValueTuple 4.6.1

‎release-notes/7.0/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ The following Microsoft.Data.SqlClient 7.0 releases have been shipped:
44

55
| Release Date | Version | Notes |
66
| :-- | :-- | :--: |
7+
| 2025-12-08 | 7.0.0-preview3.25342.7 | [Release Notes](7.0.0-preview3.md) |
78
| 2025-10-16 | 7.0.0-preview2.25289.6 | [Release Notes](7.0.0-preview2.md) |
89
| 2025-09-12 | 7.0.0-preview1.25257.1 | [Release Notes](7.0.0-preview1.md) |
910

‎release-notes/template/release-notes-template.md‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
# Release Notes
2+
3+
## [Release Type] [Version] - [Release Date]
4+
5+
### Changed
6+
7+
#### [Breaking Change or Major Change Title]
8+
9+
*What Changed:*
10+
11+
- [Detailed description of what changed, including deprecation/obsolete notices and PR reference]
12+
13+
*Who Benefits:*
14+
15+
- [Description of who benefits and why this change is being made]
16+
17+
*Impact:*
18+
19+
- [Migration guidance]
20+
- [Alternative option 1]
21+
- [Alternative option 2]
22+
- [Alternative option 3]
23+
- [Links to documentation]
24+
25+
#### Other changes
26+
27+
- [Description of change]
28+
([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM))
29+
30+
- [Category of changes] (e.g., Various test improvements, Codebase merge, Code health improvements, Internal infrastructure improvements):
31+
([#PRNUM1](https://github.com/dotnet/SqlClient/pull/PRNUM1),
32+
[#PRNUM2](https://github.com/dotnet/SqlClient/pull/PRNUM2),
33+
[#PRNUM3](https://github.com/dotnet/SqlClient/pull/PRNUM3))
34+
35+
- Updated Dependencies
36+
([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM)):
37+
- Updated `PackageName` to vX.Y.Z
38+
- Updated `PackageName` to vX.Y.Z (target framework if applicable)
39+
40+
### Fixed
41+
42+
- [Description of bug fix]
43+
([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM))
44+
45+
### Added
46+
47+
#### [Feature Name]
48+
49+
*What Changed:*
50+
51+
- [Detailed description of what changed, including PR reference]
52+
53+
*Who Benefits:*
54+
55+
- [Description of who benefits from this change]
56+
- [Additional beneficiaries or use cases]
57+
58+
*Impact:*
59+
60+
- [Description of impact and how to use the feature]
61+
- [Code example if applicable]
62+
63+
```c#
64+
// Code example
65+
```
66+
67+
- [Additional impact notes or migration guidance]
68+
69+
#### Other Additions
70+
71+
- [Description of other additions]
72+
([#PRNUM](https://github.com/dotnet/SqlClient/pull/PRNUM))
73+
74+
## Contributors
75+
(Only list public contributors. Do not list core team or bot contributors.)
76+
77+
78+
We thank the following public contributors. Their efforts toward this project are very much appreciated.
79+
80+
- [username](https://github.com/username)
81+
82+
## Target Platform Support
83+
(Look at target frameworks in the netcore and netfx project files.)
84+
85+
- [Target Framework Version] ([Supported Operating Systems])
86+
87+
### Dependencies
88+
(Use the dependencies listed at tools\specs\Microsoft.Data.SqlClient.nuspec)
89+
90+
#### [Target Framework Version]
91+
92+
- [Dependency] [Version]

0 commit comments

Comments
 (0)