From 8707dc7cb2bdbb3c2ac8a9f8e338ea140debc68e Mon Sep 17 00:00:00 2001
From: Alexander Nikolaev <55398552+alnikola@users.noreply.github.com>
Date: Fri, 5 Jun 2020 17:29:58 +0200
Subject: [PATCH 1/5] HttpRequestException.StatusCode property and ctor

---
 xml/System.Net.Http/HttpRequestException.xml | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/xml/System.Net.Http/HttpRequestException.xml b/xml/System.Net.Http/HttpRequestException.xml
index 4b7386ddd5c..297486f559a 100644
--- a/xml/System.Net.Http/HttpRequestException.xml
+++ b/xml/System.Net.Http/HttpRequestException.xml
@@ -165,11 +165,10 @@
         <Parameter Name="statusCode" Type="System.Nullable&lt;System.Net.HttpStatusCode&gt;" Index="2" FrameworkAlternate="net-5.0" />
       </Parameters>
       <Docs>
-        <param name="message">To be added.</param>
-        <param name="inner">To be added.</param>
-        <param name="statusCode">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="message">A message that describes the current exception.</param>
+        <param name="inner">The inner exception.</param>
+        <param name="statusCode">The HTTP status code.</param>
+        <summary>Initializes a new instance of the <see cref="HttpRequestException" /> class with a specific message that describes the current exception, an inner exception, and an HTTP status code.</summary>
       </Docs>
     </Member>
     <Member MemberName="StatusCode">
@@ -191,9 +190,9 @@
         <ReturnType>System.Nullable&lt;System.Net.HttpStatusCode&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets the HTTP status code to be returned with the exception.</summary>
+        <value>An HTTP status code if the exception represents a non-successful result, otherwise <c>null</c>.</value>
+        <remarks>This property is new in .NET 5.0.</remarks>
       </Docs>
     </Member>
   </Members>

From dd3e622b8e86f245713990070c22faa9a3f2e7b7 Mon Sep 17 00:00:00 2001
From: Alexander Nikolaev <55398552+alnikola@users.noreply.github.com>
Date: Thu, 11 Jun 2020 12:44:12 +0200
Subject: [PATCH 2/5] Apply suggestions from code review

Co-authored-by: Genevieve Warren <gewarren@microsoft.com>
---
 xml/System.Net.Http/HttpRequestException.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/xml/System.Net.Http/HttpRequestException.xml b/xml/System.Net.Http/HttpRequestException.xml
index 297486f559a..ba5049fd81e 100644
--- a/xml/System.Net.Http/HttpRequestException.xml
+++ b/xml/System.Net.Http/HttpRequestException.xml
@@ -168,7 +168,7 @@
         <param name="message">A message that describes the current exception.</param>
         <param name="inner">The inner exception.</param>
         <param name="statusCode">The HTTP status code.</param>
-        <summary>Initializes a new instance of the <see cref="HttpRequestException" /> class with a specific message that describes the current exception, an inner exception, and an HTTP status code.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Net.Http.HttpRequestException" /> class with a specific message that describes the current exception, an inner exception, and an HTTP status code.</summary>
       </Docs>
     </Member>
     <Member MemberName="StatusCode">
@@ -192,7 +192,7 @@
       <Docs>
         <summary>Gets the HTTP status code to be returned with the exception.</summary>
         <value>An HTTP status code if the exception represents a non-successful result, otherwise <c>null</c>.</value>
-        <remarks>This property is new in .NET 5.0.</remarks>
+        <remarks>This property was introduced in .NET 5.0.</remarks>
       </Docs>
     </Member>
   </Members>

From d3e4d09786eb655e1635d683c85680db99e35f21 Mon Sep 17 00:00:00 2001
From: Jan Jahoda <jajahoda@microsoft.com>
Date: Fri, 12 Jun 2020 10:30:05 +0200
Subject: [PATCH 3/5] ServerCertificateSelectionCallback - update documentation
 (#4351)

* ServerCertificateSelectionCallback - update documentation

* Apply suggestions from code review

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>

* Apply PR comments

Co-authored-by: Jan Jahoda <jajahoda@.microsoft.com>
Co-authored-by: Maira Wenzel <mairaw@microsoft.com>
---
 .../ServerCertificateSelectionCallback.xml    | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/xml/System.Net.Security/ServerCertificateSelectionCallback.xml b/xml/System.Net.Security/ServerCertificateSelectionCallback.xml
index 45edaee2e91..3123ea9dea1 100644
--- a/xml/System.Net.Security/ServerCertificateSelectionCallback.xml
+++ b/xml/System.Net.Security/ServerCertificateSelectionCallback.xml
@@ -29,10 +29,20 @@
     <ReturnType>System.Security.Cryptography.X509Certificates.X509Certificate</ReturnType>
   </ReturnValue>
   <Docs>
-    <param name="sender">To be added.</param>
-    <param name="hostName">To be added.</param>
-    <summary>To be added.</summary>
-    <returns>To be added.</returns>
-    <remarks>To be added.</remarks>
+    <param name="sender">A <see cref="T:System.Net.Security.SslStream" /> object.</param>
+    <param name="hostName">The host name requested by the client. If the client doesn't use the host_name TLS extension, the <paramref name="hostName" /> is an empty string.</param>   
+    <summary>Selects the server Secure Sockets Layer (SSL) certificate.</summary>
+    <returns>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> used for establishing an SSL connection.</returns>
+    <remarks>
+      <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+
+The server uses this delegate to select a server connection certificate.
+
+This delegate is used by the <xref:System.Net.Security.SslStream> class. The <xref:System.Net.Security.SslStream> class is used to help secure information exchanged between a client and server.
+
+ ]]></format>
+    </remarks>
   </Docs>
 </Type>

From 327a855bd18e94b8f228aea1f96509df6e399652 Mon Sep 17 00:00:00 2001
From: Jan Jahoda <jajahoda@microsoft.com>
Date: Fri, 12 Jun 2020 15:41:24 +0200
Subject: [PATCH 4/5] WebHeaderCollection: update item[string] property (#4268)

* Update item[string] property

* Add IEnumerable.GetEnumerator description

* Update xml/System.Net/WebHeaderCollection.xml

Co-authored-by: Karel Zikmund <karelz@microsoft.com>

* Remove Index[string]

Co-authored-by: Karel Zikmund <karelz@microsoft.com>
Co-authored-by: Jan Jahoda <jajahoda@.microsoft.com>
---
 xml/System.Net/WebHeaderCollection.xml | 48 ++------------------------
 1 file changed, 3 insertions(+), 45 deletions(-)

diff --git a/xml/System.Net/WebHeaderCollection.xml b/xml/System.Net/WebHeaderCollection.xml
index df3c531123d..137ac665ed3 100644
--- a/xml/System.Net/WebHeaderCollection.xml
+++ b/xml/System.Net/WebHeaderCollection.xml
@@ -1448,49 +1448,7 @@
         <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value" /> is greater than 65535.</exception>
         <exception cref="T:System.InvalidOperationException">This <see cref="T:System.Net.WebHeaderCollection" /> instance does not allow instances of <see cref="T:System.Net.HttpResponseHeader" />.</exception>
       </Docs>
-    </Member>
-    <Member MemberName="Item">
-      <MemberSignature Language="C#" Value="public string this[string name] { get; set; }" />
-      <MemberSignature Language="ILAsm" Value=".property instance string Item(string)" />
-      <MemberSignature Language="DocId" Value="P:System.Net.WebHeaderCollection.Item(System.String)" />
-      <MemberSignature Language="VB.NET" Value="Default Public Property Item(name As String) As String" />
-      <MemberSignature Language="C++ CLI" Value="public:&#xA; property System::String ^ default[System::String ^] { System::String ^ get(System::String ^ name); void set(System::String ^ name, System::String ^ value); };" />
-      <MemberSignature Language="F#" Value="member this.Item(string) : string with get, set" Usage="System.Net.WebHeaderCollection.Item" />
-      <MemberType>Property</MemberType>
-      <AssemblyInfo>
-        <AssemblyName>System.Net.WebHeaderCollection</AssemblyName>
-        <AssemblyVersion>4.0.0.0</AssemblyVersion>
-        <AssemblyVersion>4.1.0.0</AssemblyVersion>
-        <AssemblyVersion>4.1.1.0</AssemblyVersion>
-        <AssemblyVersion>4.1.2.0</AssemblyVersion>
-        <AssemblyVersion>5.0.0.0</AssemblyVersion>
-      </AssemblyInfo>
-      <AssemblyInfo>
-        <AssemblyName>System.Net.Requests</AssemblyName>
-      </AssemblyInfo>
-      <AssemblyInfo>
-        <AssemblyName>netstandard</AssemblyName>
-        <AssemblyVersion>2.1.0.0</AssemblyVersion>
-      </AssemblyInfo>
-      <AssemblyInfo>
-        <AssemblyName>System</AssemblyName>
-      </AssemblyInfo>
-      <AssemblyInfo>
-        <AssemblyName>System.Net</AssemblyName>
-      </AssemblyInfo>
-      <ReturnValue>
-        <ReturnType>System.String</ReturnType>
-      </ReturnValue>
-      <Parameters>
-        <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netstandard-2.1" />
-      </Parameters>
-      <Docs>
-        <param name="name">To be added.</param>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
-      </Docs>
-    </Member>
+    </Member>    
     <Member MemberName="Keys">
       <MemberSignature Language="C#" Value="public override System.Collections.Specialized.NameObjectCollectionBase.KeysCollection Keys { get; }" />
       <MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Specialized.NameObjectCollectionBase/KeysCollection Keys" />
@@ -1997,8 +1955,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an enumerator that can iterate through the <see cref="T:System.Net.WebHeaderCollection" /> instance.</summary>
+        <returns>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Net.WebHeaderCollection" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From c5f3a6b9ab3ed7b0905a95dd55837c33efb0fd9a Mon Sep 17 00:00:00 2001
From: Jan Jahoda <jajahoda@microsoft.com>
Date: Fri, 12 Jun 2020 15:42:10 +0200
Subject: [PATCH 5/5] MediaTypeNames+Application - update documentation (#4324)

* MediaTypeNames+Application - update documentation

* Apply suggestions from code review

Co-authored-by: Karel Zikmund <karelz@microsoft.com>

Co-authored-by: Jan Jahoda <jajahoda@.microsoft.com>
Co-authored-by: Karel Zikmund <karelz@microsoft.com>
---
 xml/System.Net.Mime/MediaTypeNames+Application.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/xml/System.Net.Mime/MediaTypeNames+Application.xml b/xml/System.Net.Mime/MediaTypeNames+Application.xml
index 5bdb6e1d8be..bc99cb19102 100644
--- a/xml/System.Net.Mime/MediaTypeNames+Application.xml
+++ b/xml/System.Net.Mime/MediaTypeNames+Application.xml
@@ -64,7 +64,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies that the <see cref="T:System.Net.Mime.MediaTypeNames.Application" /> data is in JSON format.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -233,7 +233,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies that the <see cref="T:System.Net.Mime.MediaTypeNames.Application" /> data is in XML format.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>