Suggestions from code review

Author: rzikm

xml/System.Net.Security/SslClientAuthenticationOptions.xml

@@ -193,9 +193,18 @@
         <ReturnType>System.Security.Cryptography.X509Certificates.X509ChainPolicy</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets an optional customized policy for remote certificate validation. If not <see langword="null" />, <see cref="P:System.Net.Security.SslClientAuthenticationOptions.CertificateRevocationCheckMode" /> and <see cref="T:System.Net.Security.SslCertificateTrust" /> used to create the <see cref="P:System.Net.Security.SslClientAuthenticationOptions.ClientCertificateContext" /> instance are ignored.</summary>
+        <summary>Gets or sets an optional customized policy for remote certificate validation</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+
+## Remarks
+
+When the value of this property is not `null`, the value of the <xref:System.Net.Security.SslClientAuthenticationOptions.CertificateRevocationCheckMode> property is ignored.
+
+When the value of this property is not `null`, any <xref:System.Net.Security.SslCertificateTrust> associated with the <xref:System.Net.Security.SslClientAuthenticationOptions.ClientCertificateContext> is ignored.
+]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CertificateRevocationCheckMode">

xml/System.Net.Security/SslServerAuthenticationOptions.xml

@@ -189,9 +189,18 @@
         <ReturnType>System.Security.Cryptography.X509Certificates.X509ChainPolicy</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets an optional customized policy for remote certificate validation. If not <see langword="null" />, <see cref="P:System.Net.Security.SslServerAuthenticationOptions.CertificateRevocationCheckMode" /> and <see cref="T:System.Net.Security.SslCertificateTrust" /> used to create the <see cref="P:System.Net.Security.SslServerAuthenticationOptions.ServerCertificateContext" /> instance are ignored.</summary>
+        <summary>Gets or sets an optional customized policy for remote certificate validation</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+
+## Remarks
+
+When the value of this property is not `null`, the value of the <xref:System.Net.Security.SslServerAuthenticationOptions.CertificateRevocationCheckMode> property is ignored.
+
+When the value of this property is not `null` and a <xref:System.Net.Security.SslCertificateTrust> was provided to the value in the <xref:System.Net.Security.SslServerAuthenticationOptions.ServerCertificateContext> property, the trust list SslCertificateTrust will be sent in the handshake (when so configured) but the trust settings from this property will not be used when verifying any client authentication certificates.
+]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CertificateRevocationCheckMode">
@@ -494,4 +503,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>