From a0dc465a5f55a699e6cc960f8056c1e1a66b87e7 Mon Sep 17 00:00:00 2001
From: ManickaP <mapichov@microsoft.com>
Date: Wed, 8 Sep 2021 19:21:01 +0200
Subject: [PATCH 1/2] Ported docs from
 https://github.com/dotnet/runtime/pull/57855

---
 .../HeaderEncodingSelector`1.xml              |  2 +-
 xml/System.Net.Http/HttpContent.xml           | 19 +++++++++++++++----
 xml/System.Net.Http/SocketsHttpHandler.xml    |  2 +-
 xml/System.Net.Security/NegotiateStream.xml   |  4 ++--
 .../SslApplicationProtocol.xml                |  2 +-
 5 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/xml/System.Net.Http/HeaderEncodingSelector`1.xml b/xml/System.Net.Http/HeaderEncodingSelector`1.xml
index 932c2de1b4b..d8519a66824 100644
--- a/xml/System.Net.Http/HeaderEncodingSelector`1.xml
+++ b/xml/System.Net.Http/HeaderEncodingSelector`1.xml
@@ -24,7 +24,7 @@
     <ReturnType>System.Text.Encoding</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="TContext">To be added.</typeparam>
+    <typeparam name="TContext">The type which headers are being encoded/decoded;</typeparam>
     <param name="headerName">The name of the header to specify for the encoding.</param>
     <param name="context">The type we are encoding/decoding the headers for.</param>
     <summary>Represents a method that specifies the encoding to use when interpreting header values.</summary>
diff --git a/xml/System.Net.Http/HttpContent.xml b/xml/System.Net.Http/HttpContent.xml
index c2acd9a919a..336270efc40 100644
--- a/xml/System.Net.Http/HttpContent.xml
+++ b/xml/System.Net.Http/HttpContent.xml
@@ -311,10 +311,21 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="net-5.0;net-6.0" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="cancellationToken">The cancellation token to cancel the operation.</param>
+        <summary>Serializes the HTTP content to a memory stream.</summary>
+        <returns>The output memory stream which contains the serialized HTTP content.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Once the operation completes, the returned memory stream represents the HTTP content. The returned stream can then be used to read the content using various stream APIs.
+            The <xref:System.Net.Http.HttpContent.CreateContentReadStream(System.Threading.CancellationToken)> method buffers the content to a memory stream.
+            Derived classes can override this behavior if there is a better way to retrieve the content as stream.
+            For example, a byte array or a string could use a more efficient method way such as wrapping a read-only MemoryStream around the bytes or string.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CreateContentReadStreamAsync">
diff --git a/xml/System.Net.Http/SocketsHttpHandler.xml b/xml/System.Net.Http/SocketsHttpHandler.xml
index 563c084b93d..693d63c2f33 100644
--- a/xml/System.Net.Http/SocketsHttpHandler.xml
+++ b/xml/System.Net.Http/SocketsHttpHandler.xml
@@ -768,7 +768,7 @@ For example, if the value is 64, then 65,536 bytes are allowed for the maximum r
         <ReturnType>System.Collections.Generic.IDictionary&lt;System.String,System.Object&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets a writable dictionary (that is, a map) of custom properties for the HttpClient requests. The dictionary is initialized empty; you can insert and query key-value pairs for your custom handlers and special processing.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml
index 0c87966e287..79e9868992b 100644
--- a/xml/System.Net.Security/NegotiateStream.xml
+++ b/xml/System.Net.Security/NegotiateStream.xml
@@ -4131,7 +4131,7 @@ This method reads asynchronously as much data as is available into `buffer` and
         <param name="buffer">A region of memory that contains the data to write to the <see cref="T:System.Net.Security.NegotiateStream" />.</param>
         <param name="cancellationToken">The token to monitor for cancellation requests.</param>
         <summary>Write asynchronously the specified number of <see cref="T:System.Byte" />s to the underlying stream.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> that represents the asynchronous read operation.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -4177,7 +4177,7 @@ This method reads asynchronously as much data as is available into `buffer` and
         <param name="count">A <see cref="T:System.Int32" /> containing the number of bytes to read from <paramref name="buffer" />.</param>
         <param name="cancellationToken">To be added.</param>
         <summary>Write asynchronously the specified number of <see cref="T:System.Byte" />s to the underlying stream.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous read operation.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
           
diff --git a/xml/System.Net.Security/SslApplicationProtocol.xml b/xml/System.Net.Security/SslApplicationProtocol.xml
index 9b995d1fa39..80ce3d650fd 100644
--- a/xml/System.Net.Security/SslApplicationProtocol.xml
+++ b/xml/System.Net.Security/SslApplicationProtocol.xml
@@ -279,7 +279,7 @@ For a complete list of supported protocols, see [TLS Application-Layer Protocol
         <ReturnType>System.Net.Security.SslApplicationProtocol</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Defines a <see cref="T:System.Net.Security.SslApplicationProtocol" /> instance for HTTP 3.0.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From 7e86e1d00d4592820458c96b063fdb9914f31f4d Mon Sep 17 00:00:00 2001
From: Carlos Sanchez <1175054+carlossanlop@users.noreply.github.com>
Date: Wed, 8 Sep 2021 12:24:54 -0700
Subject: [PATCH 2/2] Update xml/System.Net.Http/HeaderEncodingSelector`1.xml

---
 xml/System.Net.Http/HeaderEncodingSelector`1.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Net.Http/HeaderEncodingSelector`1.xml b/xml/System.Net.Http/HeaderEncodingSelector`1.xml
index d8519a66824..8da6264f7a1 100644
--- a/xml/System.Net.Http/HeaderEncodingSelector`1.xml
+++ b/xml/System.Net.Http/HeaderEncodingSelector`1.xml
@@ -24,7 +24,7 @@
     <ReturnType>System.Text.Encoding</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="TContext">The type which headers are being encoded/decoded;</typeparam>
+    <typeparam name="TContext">The type of the headers that are being encoded/decoded.</typeparam>
     <param name="headerName">The name of the header to specify for the encoding.</param>
     <param name="context">The type we are encoding/decoding the headers for.</param>
     <summary>Represents a method that specifies the encoding to use when interpreting header values.</summary>