update docs

Author: KirillKurdyukov

src/Ydb.Sdk/src/Ado/Transaction/TransactionMode.cs

@@ -8,9 +8,11 @@ namespace Ydb.Sdk.Ado;
 /// <remarks>
 /// TransactionMode defines the isolation level and consistency guarantees
 /// for database operations within a transaction.
-/// 
+///
+/// <para>
 /// For more information about YDB transaction modes, see:
 /// <see href="https://ydb.tech/docs/en/concepts/transactions">YDB Transactions Documentation</see>.
+/// </para>
 /// </remarks>
 public enum TransactionMode
 {

src/Ydb.Sdk/src/Ado/YdbConnectionStringBuilder.cs

@@ -16,8 +16,10 @@ namespace Ydb.Sdk.Ado;
 /// YdbConnectionStringBuilder provides strongly-typed properties for building YDB connection strings.
 /// It supports all standard ADO.NET connection string parameters plus YDB-specific options.
 /// 
+/// <para>
 /// For more information about YDB, see:
 /// <see href="https://ydb.tech/docs">YDB Documentation</see>.
+/// </para>
 /// </remarks>
 public sealed class YdbConnectionStringBuilder : DbConnectionStringBuilder
 {
@@ -69,7 +71,7 @@ private void InitDefaultValues()
     /// </summary>
     /// <remarks>
     /// Specifies the hostname or IP address where the YDB server is running.
-    /// Default value: localhost.
+    /// <para>Default value: localhost.</para>
     /// </remarks>
     public string Host
     {
@@ -89,7 +91,7 @@ public string Host
     /// <remarks>
     /// Specifies the port number where the YDB server is listening.
     /// Must be between 1 and 65535.
-    /// Default value: 2136.
+    /// <para>Default value: 2136.</para>
     /// </remarks>
     public int Port
     {
@@ -113,7 +115,7 @@ public int Port
     /// </summary>
     /// <remarks>
     /// Specifies the path to the YDB database to connect to.
-    /// Default value: /local.
+    /// <para>Default value: /local.</para>
     /// </remarks>
     public string Database
     {
@@ -133,7 +135,7 @@ public string Database
     /// <remarks>
     /// Specifies the username used for authenticating with the YDB server.
     /// If not specified, authentication using a username and password is disabled.
-    /// Default value: null.
+    /// <para>Default value: null.</para>
     /// </remarks>
     public string? User
     {
@@ -153,7 +155,7 @@ public string? User
     /// <remarks>
     /// Specifies the password used for authentication with the YDB server.
     /// If not specified, a password is not used.
-    /// Default value: null.
+    /// <para>Default value: null.</para>
     /// </remarks>
     public string? Password
     {
@@ -173,7 +175,7 @@ public string? Password
     /// <remarks>
     /// Specifies the maximum number of sessions that can be created and maintained
     /// in the session pool. Must be greater than 0.
-    /// Default value: 100.
+    /// <para>Default value: 100.</para>
     /// </remarks>
     public int MaxSessionPool
     {
@@ -198,7 +200,7 @@ public int MaxSessionPool
     /// <remarks>
     /// Specifies the minimum number of sessions to maintain in the session pool.
     /// Must be greater than or equal to 0.
-    /// Default value: 0.
+    /// <para>Default value: 0.</para>
     /// </remarks>
     public int MinSessionPool
     {
@@ -223,7 +225,7 @@ public int MinSessionPool
     /// <remarks>
     /// Specifies how long a session can remain idle before being closed.
     /// Must be greater than or equal to 0.
-    /// Default value: 300 seconds (5 minutes).
+    /// <para>Default value: 300 seconds (5 minutes).</para>
     /// </remarks>
     public int SessionIdleTimeout
     {
@@ -247,8 +249,8 @@ public int SessionIdleTimeout
     /// </summary>
     /// <remarks>
     /// When true, the connection uses TLS encryption (grpcs://).
-    /// When false, the connection uses plain text (grpc://).
-    /// Default value: false.
+    /// <para>When false, the connection uses plain text (grpc://).</para>
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool UseTls
     {
@@ -268,7 +270,7 @@ public bool UseTls
     /// <remarks>
     /// Specifies the path to a PEM-encoded root certificate file for TLS verification.
     /// Setting this property automatically enables TLS (UseTls = true).
-    /// Default value: null.
+    /// <para>Default value: null.</para>
     /// </remarks>
     public string? RootCertificate
     {
@@ -290,7 +292,7 @@ public string? RootCertificate
     /// <remarks>
     /// Specifies the maximum time to wait when establishing a connection to the server.
     /// Must be greater than or equal to 0. Set to 0 for infinite timeout.
-    /// Default value: 10 seconds.
+    /// <para>Default value: 10 seconds.</para>
     /// </remarks>
     public int ConnectTimeout
     {
@@ -315,7 +317,7 @@ public int ConnectTimeout
     /// <remarks>
     /// Specifies the interval between keep-alive ping messages to detect broken connections.
     /// Must be greater than or equal to 0. Set to 0 to disable keep-alive pings.
-    /// Default value: 10 seconds.
+    /// <para>Default value: 10 seconds.</para>
     /// </remarks>
     public int KeepAlivePingDelay
     {
@@ -341,7 +343,7 @@ public int KeepAlivePingDelay
     /// Specifies the maximum time to wait for a keep-alive ping response before
     /// considering the connection broken. Must be greater than or equal to 0.
     /// Set to 0 for infinite timeout.
-    /// Default value: 5 seconds.
+    /// <para>Default value: 5 seconds.</para>
     /// </remarks>
     public int KeepAlivePingTimeout
     {
@@ -369,7 +371,7 @@ public int KeepAlivePingTimeout
     /// to one node of the cluster. This is rarely needed but can improve performance for
     /// high-load scenarios with a single node.
     /// When false, uses a single HTTP/2 connection per node.
-    /// Default value: false.
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool EnableMultipleHttp2Connections
     {
@@ -390,7 +392,7 @@ public bool EnableMultipleHttp2Connections
     /// Specifies the maximum size of messages that can be sent to the server.
     /// Note: server-side limit is 64 MB. Exceeding this limit may result in
     /// "resource exhausted" errors or unpredictable behavior.
-    /// Default value: 4194304 bytes (4 MB).
+    /// <para>Default value: 4194304 bytes (4 MB).</para>
     /// </remarks>
     public int MaxSendMessageSize
     {
@@ -409,7 +411,7 @@ public int MaxSendMessageSize
     /// </summary>
     /// <remarks>
     /// Specifies the maximum size of messages that can be received from the server.
-    /// Default value: 4194304 bytes (4 MB).
+    /// <para>Default value: 4194304 bytes (4 MB).</para>
     /// </remarks>
     public int MaxReceiveMessageSize
     {
@@ -429,7 +431,7 @@ public int MaxReceiveMessageSize
     /// <remarks>
     /// When true, disables server load balancing and uses direct connections.
     /// When false, enables server load balancing for better performance.
-    /// Default value: false.
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool DisableServerBalancer
     {
@@ -449,7 +451,7 @@ public bool DisableServerBalancer
     /// <remarks>
     /// When true, disables automatic service discovery and uses direct gRPC connections.
     /// When false, enables service discovery for automatic endpoint resolution.
-    /// Default value: false.
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool DisableDiscovery
     {
@@ -469,7 +471,7 @@ public bool DisableDiscovery
     /// <remarks>
     /// Specifies the maximum time to wait when creating a new session.
     /// Must be greater than or equal to 0. Set to 0 for infinite timeout.
-    /// Default value: 5 seconds.
+    /// <para>Default value: 5 seconds.</para>
     /// </remarks>
     public int CreateSessionTimeout
     {
@@ -498,7 +500,7 @@ public int CreateSessionTimeout
     /// and sessions are not stored on the client side. Interactive client transactions are
     /// not supported in this mode.
     /// When false, the standard YDB sessions for tables (YDB has topics, coordination service, etc.) are used.
-    /// Default value: false.
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool EnableImplicitSession
     {
@@ -517,7 +519,7 @@ public bool EnableImplicitSession
     /// </summary>
     /// <remarks>
     /// Specifies the logger factory used for creating loggers throughout the SDK.
-    /// Default value: NullLoggerFactory.Instance (no logging).
+    /// <para>Default value: NullLoggerFactory.Instance (no logging).</para>
     /// </remarks>
     public ILoggerFactory LoggerFactory { get; init; } = NullLoggerFactory.Instance;
 
@@ -527,7 +529,7 @@ public bool EnableImplicitSession
     /// <remarks>
     /// Specifies the credentials provider used for authenticating with the YDB server.
     /// If not provided, authentication is not used.
-    /// Default value: null.
+    /// <para>Default value: null.</para>
     /// </remarks>
     public ICredentialsProvider? CredentialsProvider { get; init; }
 
@@ -537,7 +539,7 @@ public bool EnableImplicitSession
     /// <remarks>
     /// Specifies additional server certificates to trust for TLS verification.
     /// If not provided, the system certificate store is used.
-    /// Default value: null.
+    /// <para>Default value: null.</para>
     /// </remarks>
     public X509Certificate2Collection? ServerCertificates { get; init; }
 

src/Ydb.Sdk/src/Ado/YdbDataSource.cs

@@ -15,8 +15,10 @@ namespace Ydb.Sdk.Ado;
 /// for handling transient failures. The data source can execute operations with automatic
 /// retry logic and transaction management.
 /// 
+/// <para>
 /// For more information about YDB, see:
 /// <see href="https://ydb.tech/docs">YDB Documentation</see>.
+/// </para>
 /// </remarks>
 public class YdbDataSource
 #if NET7_0_OR_GREATER

src/Ydb.Sdk/src/Ado/YdbDataSourceBuilder.cs

@@ -9,9 +9,11 @@ namespace Ydb.Sdk.Ado;
 /// YdbDataSourceBuilder provides a fluent interface for configuring connection strings
 /// and retry policies before building a YdbDataSource instance. It supports both
 /// string-based and strongly-typed connection string configuration.
-/// 
+///
+/// <para>
 /// For more information about YDB, see:
 /// <see href="https://ydb.tech/docs">YDB Documentation</see>.
+/// </para>
 /// </remarks>
 public class YdbDataSourceBuilder
 {
@@ -68,11 +70,11 @@ public YdbDataSourceBuilder(YdbConnectionStringBuilder connectionStringBuilder)
     public string ConnectionString => ConnectionStringBuilder.ConnectionString;
 
     /// <summary>
-    /// Gets or sets the retry policy for the data source.
+    /// Gets or sets the default retry policy for the data source.
     /// </summary>
     /// <remarks>
     /// Specifies the retry policy to use for handling transient failures.
-    /// Default value is a YdbRetryPolicy with default configuration.
+    /// <para>Default value: <see cref="YdbRetryPolicy"/> with default configuration <see cref="YdbRetryPolicyConfig.Default"/>.</para>
     /// </remarks>
     public IRetryPolicy RetryPolicy { get; set; } = new YdbRetryPolicy(YdbRetryPolicyConfig.Default);
 

src/Ydb.Sdk/src/Ado/YdbProviderFactory.cs

@@ -10,8 +10,10 @@ namespace Ydb.Sdk.Ado;
 /// It provides methods to create connections, commands, parameters, and other ADO.NET objects
 /// that are specific to the YDB database provider.
 /// 
+/// <para>
 /// For more information about YDB, see:
 /// <see href="https://ydb.tech/docs">YDB Documentation</see>.
+/// </para>
 /// </remarks>
 public class YdbProviderFactory : DbProviderFactory
 {

src/Ydb.Sdk/src/Ado/YdbTransaction.cs

@@ -13,8 +13,10 @@ namespace Ydb.Sdk.Ado;
 /// changes made within the transaction. The transaction mode determines the isolation level and
 /// consistency guarantees.
 /// 
-/// For more information about YDB transactions, see:
+/// <para>
+/// For more information about YDB transaction modes, see:
 /// <see href="https://ydb.tech/docs/en/concepts/transactions">YDB Transactions Documentation</see>.
+/// </para>
 /// </remarks>
 public sealed class YdbTransaction : DbTransaction
 {

src/Ydb.Sdk/src/Ado/YdbType/YdbDbType.cs

@@ -7,9 +7,11 @@ namespace Ydb.Sdk.Ado.YdbType;
 /// </summary>
 /// <remarks>
 /// YdbDbType represents the primitive data types supported by YDB.
-/// 
+///
+/// <para>
 /// For more information about YDB primitive types, see:
-/// <see href="https://ydb.tech/docs/en/yql/reference/types/primitive">YDB Primitive Types Documentation</see>
+/// <see href="https://ydb.tech/docs/en/yql/reference/types/primitive">YDB Primitive Types Documentation</see>.
+/// </para>
 /// </remarks>
 public enum YdbDbType
 {