From bd481572e006e7203ba2fa692377870e3397ca54 Mon Sep 17 00:00:00 2001
From: Natalia Kondratyeva <knatalia@microsoft.com>
Date: Wed, 8 Sep 2021 14:40:06 +0200
Subject: [PATCH 1/2] Add WebSocket and HttpHeadersNonValidated missing APIs

---
 .../HttpHeadersNonValidated.xml                      | 10 +++++-----
 xml/System.Net.WebSockets/WebSocket.xml              | 12 ++++++------
 .../WebSocketCreationOptions.xml                     |  2 +-
 .../WebSocketDeflateOptions.xml                      |  2 +-
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
index e8096ef2a1f..895010bd891 100644
--- a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
+++ b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
@@ -213,7 +213,7 @@ Multiple header values associated with the same header name are considered to be
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
+        <param name="key">The key to locate.</param>
         <summary>Determines whether the read-only dictionary contains an element that has the specified key.</summary>
         <returns>
           <see langword="true" /> if the read-only dictionary contains an element that has the specified key; otherwise, <see langword="false" />.</returns>
@@ -264,10 +264,10 @@ Multiple header values associated with the same header name are considered to be
         <Parameter Name="value" Type="System.Net.Http.Headers.HeaderStringValues" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="key">The key to locate.</param>
+        <param name="value">When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value of <see cref="T:System.Net.Http.Headers.HeaderStringValues" />. This parameter is passed uninitialized.</param>
+        <summary>Gets the value that is associated with the specified key.</summary>
+        <returns><see langword="true" /> if the collection contains the specified header; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Net.WebSockets/WebSocket.xml b/xml/System.Net.WebSockets/WebSocket.xml
index 2b56223b227..b23c63a8bb0 100644
--- a/xml/System.Net.WebSockets/WebSocket.xml
+++ b/xml/System.Net.WebSockets/WebSocket.xml
@@ -958,12 +958,12 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="3" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <param name="messageType">To be added.</param>
-        <param name="messageFlags">To be added.</param>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="buffer">The buffer to be sent over the connection.</param>
+        <param name="messageType">One of the enumeration values that indicates whether the application is sending a binary or text message.</param>
+        <param name="messageFlags">Flags for controlling how the <see cref="T:System.Net.WebSockets.WebSocket" /> should send a message.</param>
+        <param name="cancellationToken">The cancellation token to use to cancel the send operation.</param>
+        <summary>Sends data over the <see cref="T:System.Net.WebSockets.WebSocket" /> connection asynchronously.</summary>
+        <returns>The task object representing the asynchronous operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Net.WebSockets/WebSocketCreationOptions.xml b/xml/System.Net.WebSockets/WebSocketCreationOptions.xml
index 4bc2b02d9ff..76ddb03d8a9 100644
--- a/xml/System.Net.WebSockets/WebSocketCreationOptions.xml
+++ b/xml/System.Net.WebSockets/WebSocketCreationOptions.xml
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketCreationOptions" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Net.WebSockets/WebSocketDeflateOptions.xml b/xml/System.Net.WebSockets/WebSocketDeflateOptions.xml
index aac6e515f68..3c347870120 100644
--- a/xml/System.Net.WebSockets/WebSocketDeflateOptions.xml
+++ b/xml/System.Net.WebSockets/WebSocketDeflateOptions.xml
@@ -39,7 +39,7 @@ Although the WebSocket spec allows window bits from 8 to 15, the current impleme
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates an instance of the <see cref="T:System.Net.WebSockets.WebSocketDeflateOptions" /> class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From d2b757dfae56e751e9e00e88f4b879072903c9bd Mon Sep 17 00:00:00 2001
From: Natalia Kondratyeva <knatalia@microsoft.com>
Date: Wed, 8 Sep 2021 20:14:09 +0200
Subject: [PATCH 2/2] Update
 xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
index 895010bd891..fcfdd637ad3 100644
--- a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
+++ b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml
@@ -265,7 +265,7 @@ Multiple header values associated with the same header name are considered to be
       </Parameters>
       <Docs>
         <param name="key">The key to locate.</param>
-        <param name="value">When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value of <see cref="T:System.Net.Http.Headers.HeaderStringValues" />. This parameter is passed uninitialized.</param>
+        <param name="value">When this method returns, contains the value associated with the specified key, if the key is found; otherwise, contains the default value of <see cref="T:System.Net.Http.Headers.HeaderStringValues" />. This parameter is passed uninitialized.</param>
         <summary>Gets the value that is associated with the specified key.</summary>
         <returns><see langword="true" /> if the collection contains the specified header; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>