Unify documentation for ML-DSA and SLH-DSA

Co-authored-by: PranavSenthilnathan <[email protected]>

Author: Copilot

src/libraries/Common/src/System/Security/Cryptography/MLDsaAlgorithm.cs

@@ -51,7 +51,13 @@ public sealed class MLDsaAlgorithm
         /// </value>
         public int SignatureSizeInBytes { get; }
 
-        internal string Oid { get; }
+        /// <summary>
+    ///  Gets the Object Identifier (OID) for this algorithm.
+    /// </summary>
+    /// <value>
+    ///  The Object Identifier (OID) for this algorithm.
+    /// </value>
+    internal string Oid { get; }
 
         /// <summary>
         ///  Initializes a new instance of the <see cref="MLDsaAlgorithm" /> structure with a custom name.
@@ -69,7 +75,7 @@ public sealed class MLDsaAlgorithm
         ///   The size of the signature in bytes.
         /// </param>
         /// <param name="oid">
-        ///   The OID of the algorithm.
+        ///   The Object Identifier (OID) for this algorithm.
         /// </param>
         private MLDsaAlgorithm(string name, int secretKeySizeInBytes, int publicKeySizeInBytes, int signatureSizeInBytes, string oid)
         {
@@ -80,8 +86,9 @@ private MLDsaAlgorithm(string name, int secretKeySizeInBytes, int publicKeySizeI
             Oid = oid;
         }
 
-        // TODO: Our algorithm names generally match CNG.  If they don't in this case, consider changing the values.
-        // TODO: These values match OpenSSL names, if changing this for CNG, we should make sure to do the right thing for OpenSSL.
+        // ML-DSA parameter sets, and the sizes associated with them,
+        // are defined in FIPS 204, "CRYSTALS-Dilithium: Digital Signature Algorithm
+        // Specification"
 
         /// <summary>
         ///   Gets an ML-DSA algorithm identifier for the ML-DSA-44 algorithm.

src/libraries/Common/src/System/Security/Cryptography/SlhDsa.cs

@@ -14,7 +14,7 @@ namespace System.Security.Cryptography
     ///   Represents an SLH-DSA key.
     /// </summary>
     /// <remarks>
-    ///   Developers are encouraged to program against the <c>SlhDsa</c> base class,
+    ///   Developers are encouraged to program against the <see cref="SlhDsa"/> base class,
     ///   rather than any specific derived class.
     ///   The derived classes are intended for interop with the underlying system
     ///   cryptographic libraries.

src/libraries/System.Security.Cryptography/src/System/Security/Cryptography/SlhDsaOpenSsl.cs

@@ -57,7 +57,7 @@ public SlhDsaOpenSsl(SafeEvpPKeyHandle pkeyHandle) : base(AlgorithmFromHandle(pk
         private static partial SlhDsaAlgorithm AlgorithmFromHandle(SafeEvpPKeyHandle pkeyHandle, out SafeEvpPKeyHandle upRefHandle);
 
         /// <summary>
-        /// Gets a <see cref="SafeEvpPKeyHandle" /> representation of the cryptographic key.
+        ///   Gets a <see cref="SafeEvpPKeyHandle" /> representation of the cryptographic key.
         /// </summary>
         /// <returns>A <see cref="SafeEvpPKeyHandle" /> representation of the cryptographic key.</returns>
         /// <exception cref="ObjectDisposedException">The object has already been disposed.</exception>