Fix reference to SslCertificateTrust on Ssl*AuthenticationOptions (#10505)

* Fix reference to SslCertificateTrust on Ssl*AuthenticationOptions

* Fix build

* Fix class name

* Reword

* Suggestions from code review

* Apply suggestions from code review

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

---------

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

Author: rzikm

xml/System.Net.Security/SslClientAuthenticationOptions.xml

@@ -193,9 +193,19 @@
         <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" /> 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.
+- 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,19 @@
         <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" /> 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.
+- If an <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 aren't used when verifying any client authentication certificates.
+]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CertificateRevocationCheckMode">
@@ -494,4 +504,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>