Documentation for System.Net.Http.SocketsHttpHandler.ConnectCallback (#4861)

* Documentation for System.Net.Http.SocketsHttpHandler.ConnectCallback

* Apply PR comments

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

Co-authored-by: Jan Jahoda <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>

Author: 3 people

xml/System.Net.Http/SocketsHttpConnectionContext.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents the context passed to the <see cref="P:System.Net.Http.SocketsHttpHandler.ConnectCallback" /> for a <see cref="T:System.Net.Http.SocketsHttpHandler" /> instance. .</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,7 +34,7 @@
         <ReturnType>System.Net.DnsEndPoint</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the DNS endpoint to be used by the <see cref="P:System.Net.Http.SocketsHttpHandler.ConnectCallback" /> to establish the connection.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -55,7 +55,7 @@
         <ReturnType>System.Net.Http.HttpRequestMessage</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the initial request message that is causing the connection to be created.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Net.Http/SocketsHttpHandler.xml

@@ -152,8 +152,8 @@ If this change is undesirable, you can configure your application to use the old
         <ReturnType>System.Func&lt;System.Net.Http.SocketsHttpConnectionContext,System.Threading.CancellationToken,System.Threading.Tasks.ValueTask&lt;System.IO.Stream&gt;&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets a custom callback used to open new connections.</summary>
+        <value>A callback method to create a stream.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>