update docs

Author: KirillKurdyukov

src/Ydb.Sdk/src/Ado/RetryPolicy/YdbRetryPolicy.cs

@@ -69,14 +69,14 @@ internal YdbRetryPolicy(YdbRetryPolicyConfig config, IRandom random) : this(conf
 
     /// <inheritdoc/>
     /// <remarks>
-    /// This method implements different retry strategies based on the error type:
-    /// - BadSession/SessionBusy: Immediate retry (TimeSpan.Zero)
-    /// - Aborted/Undetermined: Fast backoff with full jitter
-    /// - Unavailable/Transport errors: Fast backoff with equal jitter
-    /// - Overloaded/Resource exhausted: Slow backoff with equal jitter
-    /// - Other errors: No retry (null)
+    /// <para>This method implements different retry strategies based on the YDB status code:</para>
+    /// <para>- BadSession/SessionBusy: Immediate retry (TimeSpan.Zero)</para>
+    /// <para>- Aborted/Undetermined: Fast backoff with full jitter</para>
+    /// <para>- Unavailable/Transport errors: Fast backoff with equal jitter</para>
+    /// <para>- Overloaded/Resource exhausted: Slow backoff with equal jitter</para>
+    /// <para>- Other errors: No retry (null)</para>
     /// 
-    /// The policy respects the maximum attempt limit and idempotence settings.
+    /// <para>The policy respects the maximum attempt limit and idempotence settings.</para>
     /// </remarks>
     public TimeSpan? GetNextDelay(YdbException ydbException, int attempt)
     {

src/Ydb.Sdk/src/Ado/RetryPolicy/YdbRetryPolicyConfig.cs

@@ -25,7 +25,7 @@ public class YdbRetryPolicyConfig
     /// <remarks>
     /// The total number of attempts will be MaxAttempts (including the initial attempt).
     /// Setting this to 1 disables retries entirely.
-    /// Default value: 10.
+    /// <para>Default value: 10.</para>
     /// </remarks>
     public int MaxAttempts { get; init; } = 10;
 
@@ -36,7 +36,7 @@ public class YdbRetryPolicyConfig
     /// This is used for errors that typically resolve quickly, such as temporary
     /// unavailability or TLI (Transaction Lock Invalidated).
     /// The actual delay will be calculated using exponential backoff with jitter.
-    /// Default value: 5 ms.
+    /// <para>Default value: 5 ms.</para>
     /// </remarks>
     public int FastBackoffBaseMs { get; init; } = 5;
 
@@ -47,7 +47,7 @@ public class YdbRetryPolicyConfig
     /// This is used for errors that may take longer to resolve, such as overload
     /// or resource exhaustion. The actual delay will be calculated using
     /// exponential backoff with jitter.
-    /// Default value: 50 ms.
+    /// <para>Default value: 50 ms.</para>
     /// </remarks>
     public int SlowBackoffBaseMs { get; init; } = 50;
 
@@ -57,7 +57,7 @@ public class YdbRetryPolicyConfig
     /// <remarks>
     /// This caps the maximum delay for fast backoff to prevent excessively long waits.
     /// The exponential backoff will not exceed this value.
-    /// Default value: 500 ms.
+    /// <para>Default value: 500 ms.</para>
     /// </remarks>
     public int FastCapBackoffMs { get; init; } = 500;
 
@@ -67,7 +67,7 @@ public class YdbRetryPolicyConfig
     /// <remarks>
     /// This caps the maximum delay for slow backoff to prevent excessively long waits.
     /// The exponential backoff will not exceed this value.
-    /// Default value: 5000 ms.
+    /// <para>Default value: 5000 ms.</para>
     /// </remarks>
     public int SlowCapBackoffMs { get; init; } = 5_000;
 
@@ -80,7 +80,7 @@ public class YdbRetryPolicyConfig
     /// some statuses (like unavailable) don't indicate whether the server processed the
     /// operation - the connection might have been lost during the response. Enable this
     /// only if you are certain that the operations being retried are idempotent.
-    /// Default value: false.
+    /// <para>Default value: false.</para>
     /// </remarks>
     public bool EnableRetryIdempotence { get; init; } = false;
 

src/Ydb.Sdk/src/Ado/YdbConnection.cs

@@ -47,21 +47,27 @@ internal ISession Session
     private ISession _session = null!;
 
     /// <summary>
-    /// Initializes a new instance of the YdbConnection class.
+    /// Initializes a new instance of the <see cref="YdbConnection"/> class.
     /// </summary>
     public YdbConnection()
     {
     }
 
     /// <summary>
-    /// Initializes a new instance of the YdbConnection class with the specified connection string.
+    /// Initializes a new instance of the <see cref="YdbConnection"/> class with the specified connection string.
     /// </summary>
     /// <param name="connectionString">The connection string used to establish the connection.</param>
     public YdbConnection(string connectionString)
     {
         ConnectionStringBuilder = new YdbConnectionStringBuilder(connectionString);
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="YdbConnection"/> class with the specified connection string builder.
+    /// </summary>
+    /// <param name="connectionStringBuilder">
+    /// The <see cref="YdbConnectionStringBuilder"/> used to establish the connection.
+    /// </param>
     public YdbConnection(YdbConnectionStringBuilder connectionStringBuilder)
     {
         ConnectionStringBuilder = connectionStringBuilder;
@@ -129,6 +135,7 @@ internal async ValueTask OpenAsync(
         ConnectionState = ConnectionState.Open;
     }
 
+    /// <inheritdoc/>
     public override async Task CloseAsync()
     {
         // ReSharper disable once SwitchStatementHandlesSomeKnownEnumValuesWithDefault

src/Ydb.Sdk/src/Ado/YdbDataReader.cs

@@ -464,11 +464,6 @@ public override int GetInt32(int ordinal)
     /// </summary>
     /// <param name="ordinal">The zero-based column ordinal.</param>
     /// <returns>The value of the specified column.</returns>
-    /// <summary>
-    /// Gets the value of the specified column as a 32-bit unsigned integer.
-    /// </summary>
-    /// <param name="ordinal">The zero-based column ordinal.</param>
-    /// <returns>The value of the specified column as a 32-bit unsigned integer.</returns>
     public uint GetUint32(int ordinal)
     {
         var type = UnwrapColumnType(ordinal);