Automatically port Reflection.AssemblyHashAlgorithm (#3183)

* Automatically port Reflection.AssemblyHashAlgorithm

* Remove first line

* suggestion by rpetrusha

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

Author: carlossanlop

xml/System.Reflection/AssemblyHashAlgorithm.xml

@@ -18,7 +18,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Specifies the hash algorithms used for hashing assembly files and for generating the strong name.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -44,8 +44,22 @@
       </ReturnValue>
       <MemberValue>32771</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>Due to collision problems with MD5, Microsoft recommends SHA256.</remarks>
+        <summary>Retrieves the MD5 message-digest algorithm.</summary>
+        <remarks>
+          <format type="text/markdown">
+  <![CDATA[
+
+## Remarks
+
+> [!IMPORTANT]
+> Due to collision problems with MD5, Microsoft recommends SHA256.
+
+MD5 was developed by Rivest in 1991. It is basically MD4 with safety-belts and while it is slightly slower than MD4, it helps provide more security.
+
+The algorithm consists of four distinct rounds, which has a slightly different design from that of MD4. Message-digest size, as well as padding requirements, remain the same.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -70,7 +84,17 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>A mask indicating that there is no hash algorithm.</summary>
+        <remarks>
+          <format type="text/markdown">
+  <![CDATA[
+
+## Remarks
+
+If you specify `None` for a multi-module assembly, the common language runtime defaults to the SHA1 algorithm, since multi-module assemblies need to generate a hash.
+
+            ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Sha1">
@@ -95,7 +119,7 @@
       </ReturnValue>
       <MemberValue>32772</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Retrieves a revision of the Secure Hash Algorithm that corrects an unpublished flaw in SHA.</summary>
         <remarks>Due to collision problems with SHA1, Microsoft recommends SHA256.</remarks>
       </Docs>
     </Member>
@@ -121,7 +145,7 @@
       </ReturnValue>
       <MemberValue>32780</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Retrieves a version of the Secure Hash Algorithm with a hash size of 256 bits.</summary>
       </Docs>
     </Member>
     <Member MemberName="Sha384">
@@ -146,7 +170,7 @@
       </ReturnValue>
       <MemberValue>32781</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Retrieves a version of the Secure Hash Algorithm with a hash size of 384 bits.</summary>
       </Docs>
     </Member>
     <Member MemberName="Sha512">
@@ -171,7 +195,7 @@
       </ReturnValue>
       <MemberValue>32782</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Retrieves a version of the Secure Hash Algorithm with a hash size of 512 bits.</summary>
       </Docs>
     </Member>
   </Members>