Finalize docs for new System.Net.Primitives API-s (#9236)

* Port doc comments for System.Net.Primitives

* try to handle generic args + inheritdoc

* revert

* IPaddress

* IPAddress fixes

* IPNetwork

* docs for the new SocketException constructor

* Fix spelling

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

* revert deletion of ipString

---------

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

Author: antonfirsov

xml/System.Net.Sockets/SocketException.xml

@@ -222,9 +222,9 @@
         <Parameter Name="message" Type="System.String" Index="1" FrameworkAlternate="net-8.0" />
       </Parameters>
       <Docs>
-        <param name="errorCode">To be added.</param>
-        <param name="message">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="errorCode">The error code that indicates the error that occurred.</param>
+        <param name="message">The message that describes the error.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Net.Sockets.SocketException" /> class with the specified error code and message.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Net/IPAddress.xml

@@ -2090,7 +2090,7 @@
       </Parameters>
       <Docs>
         <param name="ipString">A character span that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6.</param>
-        <param name="ipSpan">To be added.</param>
+        <param name="ipSpan">A character span that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6.</param>
         <summary>Converts an IP address represented as a character span to an <see cref="T:System.Net.IPAddress" /> instance.</summary>
         <returns>The converted IP address.</returns>
         <remarks>To be added.</remarks>
@@ -2301,11 +2301,11 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="s">To be added.</param>
-        <param name="provider">To be added.</param>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="s">The string to parse.</param>
+        <param name="provider">An object that provides culture-specific formatting information about <paramref name="s" />.</param>
+        <param name="result">When this method returns, contains the result of successfully parsing <paramref name="s" /> or an undefined value on failure.</param>
+        <summary>Tries to parse a string into an <see cref="T:System.Net.IPAddress" />.</summary>
+        <returns><see langword="true" /> if <paramref name="s" /> was successfully parsed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2422,11 +2422,11 @@
         <Parameter Name="result" Type="System.Net.IPAddress" RefType="out" Index="2" FrameworkAlternate="net-8.0" />
       </Parameters>
       <Docs>
-        <param name="s">To be added.</param>
-        <param name="provider">To be added.</param>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="s">The span of characters to parse.</param>
+        <param name="provider">An object that provides culture-specific formatting information about <paramref name="s" />.</param>
+        <param name="result">When this method returns, contains the result of successfully parsing <paramref name="s" /> or an undefined value on failure.</param>
+        <summary>Tries to parse a span of characters into a value.</summary>
+        <returns><see langword="true" /> if <paramref name="s" /> was successfully parsed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2561,10 +2561,10 @@
         <Parameter Name="bytesWritten" Type="System.Int32" RefType="out" Index="1" FrameworkAlternate="net-8.0" />
       </Parameters>
       <Docs>
-        <param name="utf8Destination">To be added.</param>
-        <param name="bytesWritten">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="utf8Destination">The span into which to write the IP address as a span of UTF-8 bytes.</param>
+        <param name="bytesWritten">>When this method returns, the number of bytes written into the <paramref name="utf8Destination"/>.</param>
+        <summary>Tries to format the current IP address into the provided span.</summary>
+        <returns><see langword="true" /> if the formatting was successful; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2679,7 +2679,7 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="ipString">The string to validate.</param>
+        <param name="ipString">The string to parse.</param>
         <param name="address">The <see cref="T:System.Net.IPAddress" /> version of the string.</param>
         <summary>Determines whether a string is a valid IP address.</summary>
         <returns>
@@ -2775,12 +2775,12 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="ipString">The byte span to validate.</param>
+        <param name="ipString">The byte span to parse.</param>
+        <param name="ipSpan">The byte span to parse.</param>
         <param name="address">When this method returns, the <see cref="T:System.Net.IPAddress" /> version of the byte span.</param>
-        <param name="ipSpan">To be added.</param>
-        <summary>Determines whether the specified byte span represents a valid IP address.</summary>
+        <summary>Tries to parse a span of characters into a value.</summary>
         <returns>
-          <see langword="true" /> if <paramref name="ipString" /> was able to be parsed as an IP address; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if <paramref name="ipSpan" /> was able to be parsed as an IP address; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>