Address feedback

Author: cheenamalhotra

docs/connect/ado-net/appcontext-switches.md

@@ -12,6 +12,7 @@ dev_langs:
 ms.custom: sfi-ropc-nochange
 ai-usage: ai-assisted
 ---
+
 # AppContext switches in SqlClient
 
 [!INCLUDE [dotnet-all](../../includes/products/applies-full/dotnet-all.md)]
@@ -26,7 +27,7 @@ The AppContext class allows SqlClient to provide new functionality while continu
 
 (Available starting with version 7.0)
 
-To set `MultiSubnetFailover=true` globally without modifying individual connection strings, you can enable the AppContext switch **"Switch.Microsoft.Data.SqlClient.EnableMultiSubnetFailoverByDefault"** to `true` at application startup:
+To set `MultiSubnetFailover=true` globally without modifying individual connection strings, you can set the AppContext switch **"Switch.Microsoft.Data.SqlClient.EnableMultiSubnetFailoverByDefault"** to `true` at application startup:  
 
 ```csharp
 AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.EnableMultiSubnetFailoverByDefault", true);
@@ -63,7 +64,7 @@ By default, both switches are `true`, which preserves the existing (compatible)
 
 (Available starting with version 7.0)
 
-When the AppContext switch **"Switch.Microsoft.Data.SqlClient.EnableUserAgent"** is enabled, the driver sends more detailed user agent strings during connection. This information assists with troubleshooting and quantifying driver usage by version and operating system. This switch is disabled by default. To enable it, set the AppContext switch to `true` at application startup:
+When the AppContext switch **"Switch.Microsoft.Data.SqlClient.EnableUserAgent"** is enabled, the driver sends user agent details to the server as part of the connection. This information assists with troubleshooting and quantifying driver usage by version and operating system. This switch is disabled by default. To enable it, set the AppContext switch to `true` at application startup:  
 
 ```csharp
 AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.EnableUserAgent", true);

docs/connect/ado-net/introduction-microsoft-data-sqlclient-namespace.md

@@ -12,6 +12,7 @@ ms.custom:
   - sfi-ropc-nochange
   - ignite-2025
 ---
+
 # Introduction to Microsoft.Data.SqlClient namespace
 
 [!INCLUDE [Driver_ADONET_Download](../../includes/driver_adonet_download.md)]
@@ -26,7 +27,7 @@ The Microsoft.Data.SqlClient API details can be found in the [.NET API Browser](
 
 ## Stable Release 7.0.0 - 2026-03-17
 
-This is the general availability release of **Microsoft.Data.SqlClient 7.0**, a major milestone for the .NET data provider for SQL Server. This release addresses the most upvoted issue in the repository's history — extracting Azure dependencies from the core package — introduces pluggable SSPI authentication, adds enhanced routing for Azure SQL Hyperscale, and delivers async read performance improvements.
+This is the general availability release of **Microsoft.Data.SqlClient 7.0**, a major milestone for the .NET data provider for SQL Server. This release addresses the most upvoted issue in the repository's history — extracting Azure dependencies from the core package — introduces pluggable SSPI authentication, adds enhanced routing for Azure, and delivers async read performance improvements.  
 
 Also released as part of this milestone:
 
@@ -35,9 +36,9 @@ Also released as part of this milestone:
 - Released Microsoft.Data.SqlClient.Internal.Logging 1.0.0. See [release notes](https://github.com/dotnet/SqlClient/tree/main/release-notes/Internal/Logging/1.0/1.0.0.md).
 - Released Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider 7.0.0. See [release notes](https://github.com/dotnet/SqlClient/tree/main/release-notes/add-ons/AzureKeyVaultProvider/7.0/7.0.0.md).
 
-### Breaking Changes
+### Breaking changes in 7.0
 
-#### Azure Dependencies Removed from Core Package
+#### Azure dependencies removed from core package
 
 *What Changed:*
 
@@ -51,7 +52,7 @@ Also released as part of this milestone:
    [#3982](https://github.com/dotnet/SqlClient/pull/3982),
    [#3978](https://github.com/dotnet/SqlClient/pull/3978),
    [#3986](https://github.com/dotnet/SqlClient/pull/3986))
-- Two additional packages were introduced to support this separation: `Microsoft.Data.SqlClient.Extensions.Abstractions` (shared types between the core driver and extensions) and `Microsoft.Data.SqlClient.Internal.Logging` (shared ETW tracing infrastructure).
+- Two additional packages are introduced to support this separation: `Microsoft.Data.SqlClient.Extensions.Abstractions` (shared types between the core driver and extensions) and `Microsoft.Data.SqlClient.Internal.Logging` (shared ETW tracing infrastructure).  
   ([#3626](https://github.com/dotnet/SqlClient/pull/3626),
    [#3628](https://github.com/dotnet/SqlClient/pull/3628),
    [#3967](https://github.com/dotnet/SqlClient/pull/3967),
@@ -74,14 +75,14 @@ dotnet add package Microsoft.Data.SqlClient.Extensions.Azure
 - No code changes are required beyond adding the package reference.
 - If an Entra ID authentication method is used without the Azure package installed, the driver now provides an actionable error message guiding users to install the correct package.
 
-#### Other breaking changes
+#### Other breaking changes in 7.0
 
 - Reverted public visibility of internal interop enums (`IoControlCodeAccess` and `IoControlTransferType`) that were accidentally made public during the project merge.
   ([#3900](https://github.com/dotnet/SqlClient/pull/3900))
 
-### Added
+### Added in 7.0
 
-#### Pluggable Authentication with SspiContextProvider
+#### Pluggable authentication with SspiContextProvider  
 
 *What Changed:*
 
@@ -106,9 +107,9 @@ connection.Open();
 ```
 
 - The provider handles the authentication token exchange during integrated authentication. Existing authentication behavior is unchanged when no custom provider is set. See [SspiContextProvider_CustomProvider.cs](https://github.com/dotnet/SqlClient/tree/main/doc/samples/SspiContextProvider_CustomProvider.cs) for a sample implementation.
-- **Note:** The `SspiContextProvider` is part of the connection pool key. Care should be taken when using this property to ensure the implementation returns a stable identity per resource.
+- **Note:** The `SspiContextProvider` is part of the connection pool key. Ensure the implementation returns a consistent identity per resource.  
 
-#### Async Read Performance: Packet Multiplexing (Preview)
+#### Async read performance: Packet multiplexing (preview)
 
 *What Changed:*
 
@@ -144,7 +145,7 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseCompatibilityProcessSni
 
 *Who Benefits:*
 
-- Users connecting to Azure SQL Hyperscale environments that use named read replicas and gateway-based load balancing.
+- Users connecting to Azure environments that use named read replicas and gateway-based load balancing.
 
 *Impact:*
 
@@ -165,7 +166,7 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseCompatibilityProcessSni
 
 - SqlClient 7.0 compiles and tests against .NET 10, ensuring compatibility.
 
-#### Strongly-Typed Diagnostic Events on .NET Framework
+#### Strongly-typed diagnostic events on .NET Framework
 
 *What Changed:*
 
@@ -201,7 +202,7 @@ listener.Subscribe(new Observer<KeyValuePair<string, object?>>(kvp =>
 
 - The types implement `IReadOnlyList<KeyValuePair<string, object>>` for backward compatibility with code that iterates properties generically.
 
-#### Other Additions
+#### Other additions in 7.0
 
 - Added `SqlConfigurableRetryFactory.BaselineTransientErrors` static property exposing the default transient error codes list as a `ReadOnlyCollection<int>`, making it easier to extend the default list with application-specific error codes.
   ([#3903](https://github.com/dotnet/SqlClient/pull/3903))
@@ -215,7 +216,7 @@ listener.Subscribe(new Observer<KeyValuePair<string, object?>>(kvp =>
 - Enabled User Agent Feature Extension (opt-in via `Switch.Microsoft.Data.SqlClient.EnableUserAgent`).
   ([#3606](https://github.com/dotnet/SqlClient/pull/3606))
 
-### Changed
+### Changed in 7.0
 
 #### Deprecation of `SqlAuthenticationMethod.ActiveDirectoryPassword`
 
@@ -241,7 +242,7 @@ listener.Subscribe(new Observer<KeyValuePair<string, object?>>(kvp =>
 
 - See [Connect to Azure SQL with Microsoft Entra authentication](/connect/ado-net/sql/azure-active-directory-authentication) for more information.
 
-## Target Platform Support
+## Target Platform Support for 7.0
 
 - .NET Framework 4.6.2+ (Windows x86, Windows x64, Windows ARM64)
 - .NET 8.0+ (Windows x86, Windows x64, Windows ARM, Windows ARM64, Linux, macOS)

docs/connect/ado-net/sql/azure-active-directory-authentication.md

@@ -28,7 +28,7 @@ This article describes how to connect to Azure SQL data sources by using Microso
 Microsoft Entra authentication uses identities in Microsoft Entra ID to access data sources such as Azure SQL Database, Azure SQL Managed Instance, and Azure Synapse Analytics. The **Microsoft.Data.SqlClient** namespace allows client applications to specify Microsoft Entra credentials in different authentication modes when they're connecting to Azure SQL Database and Azure SQL Managed Instance. To use Microsoft Entra authentication with Azure SQL, you must [configure and manage Microsoft Entra authentication with Azure SQL](/azure/azure-sql/database/authentication-aad-configure).
 
 > [!IMPORTANT]
-> Starting with **Microsoft.Data.SqlClient 7.0**, Azure and Microsoft Entra ID dependencies are no longer included in the core `Microsoft.Data.SqlClient` package. If your application uses any Microsoft Entra authentication mode (such as `Active Directory Default`, `Active Directory Managed Identity`, `Active Directory Interactive`, etc.) with driver implementation, you must install the **Microsoft.Data.SqlClient.Extensions.Azure** NuGet package separately. For migration steps, see [Migrate to Microsoft.Data.SqlClient 7.0](#migrate-to-microsoftdatasqlclient-70).
+> Starting with **Microsoft.Data.SqlClient 7.0**, Azure and Microsoft Entra ID dependencies are no longer included in the core `Microsoft.Data.SqlClient` package. If your library or application supports any Microsoft Entra authentication mode (such as `Active Directory Default`, `Active Directory Managed Identity`, `Active Directory Interactive`, etc.), you must include a dependency on the **Microsoft.Data.SqlClient.Extensions.Azure** NuGet package. For migration steps, see [Migrate to Microsoft.Data.SqlClient 7.0](#migrate-to-microsoftdatasqlclient-70).  
 
 When you set the `Authentication` connection property in the connection string, the client can choose a preferred Microsoft Entra authentication mode according to the value provided:
 
@@ -37,7 +37,7 @@ When you set the `Authentication` connection property in the connection string,
 
   A new `Active Directory Service Principal` authentication mode is also added in SqlClient 2.0.0. It makes use of the client ID and secret of a service principal identity to accomplish authentication.
 - More authentication modes are added in **Microsoft.Data.SqlClient** 2.1.0, including `Active Directory Device Code Flow` and `Active Directory Managed Identity` (also known as `Active Directory MSI`). These new modes enable the application to acquire an access token to connect to the server.
-- Starting with **Microsoft.Data.SqlClient** 7.0.0, all Microsoft Entra authentication implementation is delivered through the separate `Microsoft.Data.SqlClient.Extensions.Azure` package. The core driver package no longer carries Azure dependencies.
+- Starting with **Microsoft.Data.SqlClient** 7.0.0, Microsoft Entra authentication support is provided through the separate `Microsoft.Data.SqlClient.Extensions.Azure` package. The core driver package no longer carries Azure dependencies.  
 
 For information about Microsoft Entra authentication beyond what the following sections describe, see [Use Microsoft Entra authentication](/azure/azure-sql/database/authentication-aad-overview).
 
@@ -452,7 +452,7 @@ Or by using the NuGet Package Manager in Visual Studio, search for **Microsoft.D
 > No code changes are required beyond adding the package reference. The extension package registers its authentication providers automatically.
 
 > [!NOTE]
-> You are not required to include the **Microsoft.Data.SqlClient.Extensions.Azure** package reference if your application references code that implements the Entra ID Authentication modes or you connect to Azure SQL using token-based authentication. This package reference is only needed to utilize driver-provided implementation of Entra ID authentication modes.
+> You are not required to include the **Microsoft.Data.SqlClient.Extensions.Azure** package reference if your application implements the Entra ID Authentication modes itself or you connect to Azure SQL using token-based authentication. This package reference is only required for the driver-provided implementation of Entra ID authentication modes.  
 
 ### Step 2: Replace deprecated authentication modes
 

docs/connect/ado-net/sqlclient-driver-support-lifecycle.md

@@ -69,7 +69,7 @@ New stable (GA) releases for `Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyV
 | 2.x | March 3, 2021 | 2.0.0 | March 3, 2021 | LTS | March 4, 2024 |
 | 1.x | November 19, 2019 | 1.2.0 | December 01, 2020 | LTS | November 21, 2022 |
 
-## Microsoft.Data.SqlClient Extensions
+## Microsoft.Data.SqlClient extensions
 
 The major versions of extensions NuGet packages shipped starting with Microsoft.Data.SqlClient v7.0 onwards follow an LTS support cycle: