Port System.Net.WebSockets triple slash comments to Docs (#2319)

* Port System.Net.WebSockets triple slash comments to Docs

* Apply suggestions from code review

Suggestions provided by davidsh and karelz.

Co-Authored-By: carlossanlop <[email protected]>

* Apply suggestions from code review

Suggestions by mairaw

Co-Authored-By: carlossanlop <[email protected]>

Author: carlossanlop

xml/System.Net.WebSockets/ValueWebSocketReceiveResult.xml

@@ -49,10 +49,10 @@
         <Parameter Name="endOfMessage" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="count">To be added.</param>
-        <param name="messageType">To be added.</param>
-        <param name="endOfMessage">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="count">The number of bytes that the <see cref="T:System.Net.WebSockets.WebSocket" /> received.</param>
+        <param name="messageType">One of the enumeration values that indicates whether the current message is a UTF-8 message or a binary message.</param>
+        <param name="endOfMessage"><see langword="true" /> to indicate the messsage has been received completely; otherwise, <see langword="false" />.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Net.WebSockets.ValueWebSocketReceiveResult" /> struct. An instance of this struct represents the result of performing a single <c>ReceiveAsync</c> operation on a <see cref="T:System.Net.WebSockets.WebSocket" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -132,4 +132,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Net.WebSockets/WebSocket.xml

@@ -400,12 +400,12 @@
         <Parameter Name="keepAliveInterval" Type="System.TimeSpan" Index="3" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="stream">To be added.</param>
-        <param name="isServer">To be added.</param>
-        <param name="subProtocol">To be added.</param>
-        <param name="keepAliveInterval">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="stream">The stream for the connection.</param>
+        <param name="isServer"><see langword="true" /> to indicate it's the server-side of the connection; <see langword="false" /> if it's the client-side.</param>
+        <param name="subProtocol">The agreed upon sub-protocol that was used when creating the connection.</param>
+        <param name="keepAliveInterval">The keep-alive interval to use, or <see cref="F:System.Threading.Timeout.InfiniteTimeSpan" /> to disable keep-alives.</param>
+        <summary>Creates a new <see cref="T:System.Net.WebSockets.WebSocket" /> object that operates on the specified stream, which represents a web socket connection.</summary>
+        <returns>The new web socket.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -933,4 +933,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>