From 73920b27ad30830639e1bb1087c1465637a4f41e Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 29 Sep 2025 14:31:52 -0700 Subject: [PATCH 1/3] Test Markdown style link --- xml/System.IO.Compression/BrotliStream.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.IO.Compression/BrotliStream.xml b/xml/System.IO.Compression/BrotliStream.xml index 49254e8a43d..fd252e46c70 100644 --- a/xml/System.IO.Compression/BrotliStream.xml +++ b/xml/System.IO.Compression/BrotliStream.xml @@ -551,7 +551,7 @@ The `DisposeAsync` method lets you perform a resource-intensive dispose operation without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. This method disposes the Brotli stream by writing any changes to the backing store and closing the stream to release resources. - Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see Cleaning Up Unmanaged Resources. + Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). From 7bb1d8f005280fa8820b0d77718c7d3ed2bb5e9a Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 29 Sep 2025 14:52:40 -0700 Subject: [PATCH 2/3] Try without para tags Added additional remarks about resource management and UI thread considerations when using DisposeAsync. --- xml/System.IO.Compression/BrotliStream.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/xml/System.IO.Compression/BrotliStream.xml b/xml/System.IO.Compression/BrotliStream.xml index fd252e46c70..0020baeb973 100644 --- a/xml/System.IO.Compression/BrotliStream.xml +++ b/xml/System.IO.Compression/BrotliStream.xml @@ -549,6 +549,7 @@ Asynchronously releases the unmanaged resources used by the . A task that represents the asynchronous dispose operation. + Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). The `DisposeAsync` method lets you perform a resource-intensive dispose operation without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. This method disposes the Brotli stream by writing any changes to the backing store and closing the stream to release resources. Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). From 1e3799e69eeff30d3611e4e3077fa367d4619d0b Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 29 Sep 2025 15:21:47 -0700 Subject: [PATCH 3/3] More tests... --- xml/System.IO.Compression/BrotliStream.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/xml/System.IO.Compression/BrotliStream.xml b/xml/System.IO.Compression/BrotliStream.xml index 0020baeb973..a00287b2a17 100644 --- a/xml/System.IO.Compression/BrotliStream.xml +++ b/xml/System.IO.Compression/BrotliStream.xml @@ -549,10 +549,10 @@ Asynchronously releases the unmanaged resources used by the . A task that represents the asynchronous dispose operation. - Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). The `DisposeAsync` method lets you perform a resource-intensive dispose operation without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. This method disposes the Brotli stream by writing any changes to the backing store and closing the stream to release resources. Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). + Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). @@ -589,7 +589,7 @@ The reference to the pending asynchronous request to finish. Waits for the pending asynchronous read to complete. (Consider using the method instead.) The number of bytes read from the stream, between 0 (zero) and the number of bytes you requested. returns 0 only at the end of the stream; otherwise, it blocks until at least one byte is available. - To be added. + Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). is .