Document 2 APIs in System.Security.Cryptography.DCACng (#2968)

* Document 2 APIs in System.Security.Cryptography.DSACng

* suggestions

Co-Authored-By: Eric StJohn <[email protected]>
Co-Authored-By: Ron Petrusha <[email protected]>

* suggestion by mairaw

Co-Authored-By: Maira Wenzel <[email protected]>

Author: 2 people

xml/System.Security.Cryptography/DSACng.xml

@@ -171,10 +171,8 @@
         <summary>Creates the digital signature for the specified data.</summary>
         <returns>The digital signature for the specified data.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">
-          <paramref name="rgbHash" /> is <see langword="null" />.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">
-          <paramref name="rgbHash" /> is shorter in length than the Q value of the DSA key .</exception>
+        <exception cref="T:System.ArgumentNullException"><paramref name="rgbHash" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.PlatformNotSupportedException"><paramref name="rgbHash" /> is shorter in length than the Q value of the DSA key .</exception>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -485,11 +483,11 @@
         <Parameter Name="bytesWritten" Type="System.Int32" RefType="out" Index="2" FrameworkAlternate="netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="hash">To be added.</param>
-        <param name="destination">To be added.</param>
-        <param name="bytesWritten">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="hash">A read-only span of bytes containing a hash of the data to be signed.</param>
+        <param name="destination">The buffer where the digital signature is to be written.</param>
+        <param name="bytesWritten">When this method returns, the number of bytes that were written in <paramref name="destination" />.</param>
+        <summary>Tries to create the digital signature for the specified data.</summary>
+        <returns><see langword="true" /> if the digital signature was created successfully; <see langword="false" /> if the <paramref name="destination" /> buffer was too small.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -561,16 +559,14 @@
         <param name="rgbHash">The signed data.</param>
         <param name="rgbSignature">The digital signature to be verified.</param>
         <summary>Verifies if the specified digital signature matches the specified data.</summary>
-        <returns>
-          <see langword="true" /> if <paramref name="rgbSignature" /> matches the signature computed using the specified data; otherwise, <see langword="false" />.</returns>
+        <returns><see langword="true" /> if <paramref name="rgbSignature" /> matches the signature computed using the specified data; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">The <paramref name="rgbHash" /> parameter is <see langword="null" />.  
 
  -or-  
 
  The <paramref name="rgbSignature" /> parameter is <see langword="null" />.</exception>
-        <exception cref="T:System.PlatformNotSupportedException">
-          <paramref name="rgbHash" /> is shorter in length than the Q value of the DSA key .</exception>
+        <exception cref="T:System.PlatformNotSupportedException"><paramref name="rgbHash" /> is shorter in length than the Q value of the DSA key.</exception>
       </Docs>
     </Member>
     <Member MemberName="VerifySignature">
@@ -596,12 +592,13 @@
         <Parameter Name="signature" Type="System.ReadOnlySpan&lt;System.Byte&gt;" Index="1" FrameworkAlternate="netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="hash">To be added.</param>
-        <param name="signature">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="hash">A read-only span of bytes containing the signed data.</param>
+        <param name="signature">A read-only span of bytes containing the signature to be verified.</param>
+        <summary>Verifies if the specified digital signature matches the specified data.</summary>
+        <returns><see langword="true" /> if <paramref name="signature" /> matches the signature computed using the specified data; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.PlatformNotSupportedException"><paramref name="hash" /> is shorter in length than the Q value of the DSA key.</exception>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>