update docs

Author: KirillKurdyukov

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

@@ -135,7 +135,6 @@ internal async ValueTask OpenAsync(
         ConnectionState = ConnectionState.Open;
     }
 
-    /// <inheritdoc/>
     public override async Task CloseAsync()
     {
         // ReSharper disable once SwitchStatementHandlesSomeKnownEnumValuesWithDefault

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

@@ -249,7 +249,7 @@ public int SessionIdleTimeout
     /// </summary>
     /// <remarks>
     /// When true, the connection uses TLS encryption (grpcs://).
-    /// <para>When false, the connection uses plain text (grpc://).</para>
+    /// When false, the connection uses plain text (grpc://).
     /// <para>Default value: false.</para>
     /// </remarks>
     public bool UseTls

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

@@ -797,6 +797,13 @@ public override IEnumerator<YdbDataRecord> GetEnumerator()
     /// <remarks>
     /// This method closes the reader and releases any resources associated with it.
     /// If the reader is closed during a transaction, the transaction will be marked as failed.
+    /// 
+    /// <para>
+    /// Important: If the stream is not fully read to the end, the session associated with this stream
+    /// and the corresponding <see cref="YdbConnection"/> will be marked as invalid to avoid
+    /// <see cref="StatusCode.SessionBusy"/> errors. Because the session may be returned to the pool
+    /// and immediately reused for a new request while the previous one is still not completed.
+    /// </para>
     /// </remarks>
     public override async Task CloseAsync()
     {
@@ -831,6 +838,13 @@ public override async Task CloseAsync()
     /// <remarks>
     /// This method closes the reader and releases any resources associated with it.
     /// If the reader is closed during a transaction, the transaction will be marked as failed.
+    /// 
+    /// <para>
+    /// Important: If the stream is not fully read to the end, the session associated with this stream
+    /// and the corresponding <see cref="YdbConnection"/> will be marked as invalid to avoid
+    /// <see cref="StatusCode.SessionBusy"/> errors. Because the session may be returned to the pool
+    /// and immediately reused for a new request while the previous one is still not completed.
+    /// </para>
     /// </remarks>
     public override void Close() => CloseAsync().GetAwaiter().GetResult();
 
@@ -922,6 +936,13 @@ private void OnFailReadStream()
     /// <returns>A ValueTask representing the asynchronous disposal operation.</returns>
     /// <remarks>
     /// This method closes the reader and releases any resources associated with it.
+    /// 
+    /// <para>
+    /// Important: If the stream is not fully read to the end, the session associated with this stream
+    /// and the corresponding <see cref="YdbConnection"/> will be marked as invalid to avoid
+    /// <see cref="StatusCode.SessionBusy"/> errors. Because the session may be returned to the pool
+    /// and immediately reused for a new request while the previous one is still not completed.
+    /// </para>
     /// </remarks>
     public override async ValueTask DisposeAsync() => await CloseAsync();