Apply suggestions from code review

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

Author: ManickaP

xml/System.Net.Quic/QuicConnectionOptions.xml

@@ -243,8 +243,8 @@ To use a different close error code, call <xref:System.Net.Quic.QuicConnection.C
         </summary>
         <value>To be added.</value>
         <remarks>
-          <para>The callback values represent increments of stream limits, e.g.: current limit is 10 bidirectional streams, callback arguments notify 5 more additional bidirectional streams =&gt; 15 bidirectional streams can be opened in total at the moment.</para>
-          <para>The initial capacity is reported with the first invocation of the callback that might happen before the <see cref="T:System.Net.Quic.QuicConnection" /> instance is handed out via either <see cref="M:System.Net.Quic.QuicConnection.ConnectAsync(System.Net.Quic.QuicClientConnectionOptions,System.Threading.CancellationToken)" /> or <see cref="M:System.Net.Quic.QuicListener.AcceptConnectionAsync(System.Threading.CancellationToken)" />.</para>
+          <para>The callback values represent increments of stream limits. For example, if the current limit is 10 bidirectional streams, and callback arguments notify 5 more additional bidirectional streams, then 15 bidirectional streams can be opened in total at the moment.</para>
+          <para>The initial capacity is reported with the first invocation of the callback, which might happen before the <see cref="T:System.Net.Quic.QuicConnection" /> instance is handed out via either <see cref="M:System.Net.Quic.QuicConnection.ConnectAsync(System.Net.Quic.QuicClientConnectionOptions,System.Threading.CancellationToken)" /> or <see cref="M:System.Net.Quic.QuicListener.AcceptConnectionAsync(System.Threading.CancellationToken)" />.</para>
         </remarks>
       </Docs>
     </Member>

xml/System.Net.Quic/QuicListener.xml

@@ -39,7 +39,7 @@ For QUIC prerequisites and supported operating systems, see [Platform dependenci
       ]]></format>
     </remarks>
     <related type="Article" href="https://www.rfc-editor.org/rfc/rfc9000.html#name-connections">RFC 9000: Connections</related>
-    <related type="ExternalDocumentation" href="/dotnet/fundamentals/networking/quic/quic-overview#quiclistener">Guidelines for using QuicListener</related>
+    <related type="Article" href="/dotnet/fundamentals/networking/quic/quic-overview#quiclistener">Guidelines for using QuicListener</related>
   </Docs>
   <Members>
     <Member MemberName="AcceptConnectionAsync">

xml/System.Net.Quic/QuicListenerOptions.xml

@@ -24,7 +24,7 @@
   <Docs>
     <summary>Options to configure a new <see cref="T:System.Net.Quic.QuicListener" />.</summary>
     <remarks>To be added.</remarks>
-    <related type="ExternalDocumentation" href="/dotnet/fundamentals/networking/quic/quic-options#quiclisteneroptions">Detailed documentation for QuicListenerOptions</related>
+    <related type="Article" href="/dotnet/fundamentals/networking/quic/quic-options#quiclisteneroptions">Detailed documentation for QuicListenerOptions</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
@@ -66,7 +66,7 @@
       <Docs>
         <summary>Gets or sets the list of application protocols that the listener will accept. At least one must be specified.</summary>
         <value>To be added.</value>
-        <remarks>This property is mandatory, not setting or not specifying at least one value will result in validation errors when starting the listener.</remarks>
+        <remarks>This property is mandatory. Not setting it or not specifying at least one value will result in validation errors when starting the listener.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ConnectionOptionsCallback">
@@ -95,7 +95,7 @@
       <Docs>
         <summary>Gets or sets the selection callback to choose inbound connection options.</summary>
         <value>To be added.</value>
-        <remarks>This property is mandatory, not setting it will result in validation errors when starting the listener.</remarks>
+        <remarks>This property is mandatory. Not setting it will result in validation errors when starting the listener.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ListenBacklog">
@@ -141,7 +141,7 @@
       <Docs>
         <summary>Gets or sets the endpoint to listen on.</summary>
         <value>To be added.</value>
-        <remarks>This property is mandatory, not setting will result in validation errors when starting the listener.</remarks>
+        <remarks>This property is mandatory. Not setting it will result in validation errors when starting the listener.</remarks>
       </Docs>
     </Member>
   </Members>

xml/System.Net.Quic/QuicServerConnectionOptions.xml

@@ -24,7 +24,7 @@
   <Docs>
     <summary>Options for server (inbound) <see cref="T:System.Net.Quic.QuicConnection">Quic connections</see>. These options are provided by <see cref="P:System.Net.Quic.QuicListenerOptions.ConnectionOptionsCallback" />.</summary>
     <remarks>To be added.</remarks>
-    <related type="ExternalDocumentation" href="/dotnet/fundamentals/networking/quic/quic-options#quicserverconnectionoptions">Detailed documentation for QuicServerConnectionOptions</related>
+    <related type="Article" href="/dotnet/fundamentals/networking/quic/quic-options#quicserverconnectionoptions">Detailed documentation for QuicServerConnectionOptions</related>
   </Docs>
   <Members>
     <Member MemberName=".ctor">

xml/System.Net.Quic/QuicStream.xml

@@ -30,7 +30,7 @@ Apart from a stream API, <see cref="T:System.Net.Quic.QuicStream" /> also expose
 
 <list type="bullet"><item><term><see cref="M:System.Net.Quic.QuicStream.WriteAsync(System.ReadOnlyMemory{System.Byte},System.Boolean,System.Threading.CancellationToken)" /></term><description>Closes the writing side of the stream as a single operation with the write itself.</description></item><item><term><see cref="M:System.Net.Quic.QuicStream.CompleteWrites" /></term><description>Closes the writing side of the stream.</description></item><item><term><see cref="M:System.Net.Quic.QuicStream.Abort(System.Net.Quic.QuicAbortDirection,System.Int64)" /></term><description>Aborts either the writing or the reading side of the stream.</description></item><item><term><see cref="M:System.Net.Quic.QuicStream.WritesClosed" /></term><description>Returns a <see cref="T:System.Threading.Tasks.Task" /> that will complete when the stream writing side has been closed (gracefully or abortively).</description></item><item><term><see cref="P:System.Net.Quic.QuicStream.ReadsClosed" /></term><description>Returns a <see cref="T:System.Threading.Tasks.Task" /> that will complete when the stream reading side has been closed (gracefully or abortively).</description></item></list></remarks>
     <related type="Article" href="https://www.rfc-editor.org/rfc/rfc9000.html#name-streams">RFC 9000: Streams</related>
-    <related type="ExternalDocumentation" href="/dotnet/fundamentals/networking/quic/quic-overview#quicstream">Guidelines for using QuicStream</related>
+    <related type="Article" href="/dotnet/fundamentals/networking/quic/quic-overview#quicstream">Guidelines for using QuicStream</related>
   </Docs>
   <Members>
     <Member MemberName="Abort">

xml/ns-System.Net.Quic.xml

@@ -2,6 +2,6 @@
   <Docs>
     <summary>Contains types that implement the QUIC protocol specified by <see href="https://www.rfc-editor.org/rfc/rfc9000.html">RFC 9000</see>.</summary>
     <remarks>To be added.</remarks>
-    <related type="ExternalDocumentation" href="/dotnet/fundamentals/networking/quic/quic-overview">QUIC in .NET</related>
+    <related type="Article" href="/dotnet/fundamentals/networking/quic/quic-overview">QUIC in .NET</related>
   </Docs>
 </Namespace>