diff --git a/xml/System.Threading.Channels/ChannelWriter`1.xml b/xml/System.Threading.Channels/ChannelWriter`1.xml
index 5b1b9c9c3cc..1f8f9ccb287 100644
--- a/xml/System.Threading.Channels/ChannelWriter`1.xml
+++ b/xml/System.Threading.Channels/ChannelWriter`1.xml
@@ -196,9 +196,14 @@
       <Docs>
         <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the wait operation.</param>
         <summary>Returns a <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete when space is available to write an item.</summary>
-        <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when space is available to write an item
-            or with a <see langword="false" /> result when no further writing will be permitted.</returns>
-        <remarks>To be added.</remarks>
+        <returns>
+          <para>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a <see langword="true" /> result when space is available to write an item
+            or with a <see langword="false" /> result when no further writing will be permitted.</para>
+          <para>If the channel was completed with an exception, this task will also complete with an exception.</para>
+        </returns>
+        <exception cref="T:System.Threading.Channels.ChannelClosedException">The channel has already been marked as complete, including an inner exception.</exception>
+        <remarks>If the channel was already closed, this method does not return <see langword="true" />. Whether it returns <see langword="false" /> or throws an exception
+          depends on whether an exception was provided in the call to complete it or not.</remarks>
       </Docs>
     </Member>
     <Member MemberName="WriteAsync">
@@ -236,6 +241,7 @@
         <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> used to cancel the write operation.</param>
         <summary>Asynchronously writes an item to the channel.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous write operation.</returns>
+        <exception cref="T:System.Threading.Channels.ChannelClosedException">The channel has already been marked as complete.</exception>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>