diff --git a/xml/System.Reflection.Metadata/AssemblyFile.xml b/xml/System.Reflection.Metadata/AssemblyFile.xml
index 0f1f8f12b46..a62084292ea 100644
--- a/xml/System.Reflection.Metadata/AssemblyFile.xml
+++ b/xml/System.Reflection.Metadata/AssemblyFile.xml
@@ -52,7 +52,15 @@
         <summary>Gets a value that indicates whether the file contains metadata.</summary>
         <value>
           <see langword="true" /> if the file contains metadata, <see langword="false" /> otherwise.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Flags` field of the `File` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetCustomAttributes">
@@ -105,7 +113,15 @@
       <Docs>
         <summary>Gets the hash value of the file content calculated using <see cref="P:System.Reflection.Metadata.AssemblyDefinition.HashAlgorithm" />.</summary>
         <value>A <see cref="T:System.Reflection.Metadata.BlobHandle" /> instance representing the hash value of the file content.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `HashValue` field of the `File` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -131,7 +147,15 @@
       <Docs>
         <summary>Gets the file name, including its extension.</summary>
         <value>A <see cref="T:System.Reflection.Metadata.StringHandle" /> instance representing the file name with its extension.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Name` field of the `File` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Reflection.Metadata/AssemblyFileHandleCollection.xml b/xml/System.Reflection.Metadata/AssemblyFileHandleCollection.xml
index e772147646b..7068ccb5bff 100644
--- a/xml/System.Reflection.Metadata/AssemblyFileHandleCollection.xml
+++ b/xml/System.Reflection.Metadata/AssemblyFileHandleCollection.xml
@@ -37,7 +37,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Represents a collection of <see cref="T:System.Reflection.Metadata.AssemblyFileHandle" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Reflection.Metadata/AssemblyReferenceHandleCollection.xml b/xml/System.Reflection.Metadata/AssemblyReferenceHandleCollection.xml
index a1897275a08..25e48aaa752 100644
--- a/xml/System.Reflection.Metadata/AssemblyReferenceHandleCollection.xml
+++ b/xml/System.Reflection.Metadata/AssemblyReferenceHandleCollection.xml
@@ -37,7 +37,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>A collection of assembly references.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Reflection.Metadata/BlobBuilder.xml b/xml/System.Reflection.Metadata/BlobBuilder.xml
index 49bccc133cd..4c16cbfe8cf 100644
--- a/xml/System.Reflection.Metadata/BlobBuilder.xml
+++ b/xml/System.Reflection.Metadata/BlobBuilder.xml
@@ -850,7 +850,19 @@
       <Docs>
         <param name="value">The value to write.</param>
         <summary>Implements compressed unsigned integer encoding as defined by ECMA-335-II chapter 23.2: Blobs and signatures.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the value lies between 0 (0x00) and 127 (0x7F), inclusive, encode as a one-byte integer (bit 7 is clear, value held in bits 6 through 0).
+
+If the value lies between 28 (0x80) and 214 - 1 (0x3FFF), inclusive, encode as a 2-byte integer with bit 15 set, bit 14 clear (value held in bits 13 through 0).
+
+Otherwise, encode as a 4-byte integer, with bit 31 set, bit 30 set, bit 29 clear (value held in bits 28 through 0).
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="value" /> can't be represented as a compressed unsigned integer.</exception>
         <exception cref="T:System.InvalidOperationException">The builder is not writable; it has been linked with another one.</exception>
@@ -880,7 +892,19 @@
       <Docs>
         <param name="value">The value to write.</param>
         <summary>Implements compressed signed integer encoding as defined by ECMA-335-II chapter 23.2: Blobs and signatures.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the value lies between -64 (0xFFFFFFC0) and 63 (0x3F), inclusive, encode as a one-byte integer:  bit 7 clear, value bits 5 through 0 held in bits 6 through 1, sign bit (value bit 31) in bit 0.
+
+If the value lies between -8192 (0xFFFFE000) and 8191 (0x1FFF), inclusive, encode as a two-byte integer: 15 set, bit 14 clear, value bits 12 through 0 held in bits 13 through 1, sign bit(value bit 31) in bit 0.
+
+If the value lies between -268435456 (0xF000000) and 268435455 (0x0FFFFFFF), inclusive, encode as a four-byte integer: 31 set, 30 set, bit 29 clear, value bits 27 through 0 held in bits 28 through 1, sign bit(value bit 31) in bit 0.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="value" /> can't be represented as a compressed signed integer.</exception>
         <exception cref="T:System.InvalidOperationException">The builder is not writable; it has been linked with another one.</exception>
@@ -1341,7 +1365,17 @@
       <Docs>
         <param name="value">To be added.</param>
         <summary>Writes a string in SerString format (see ECMA-335-II 23.3 Custom attributes).</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The string is UTF8 encoded and prefixed by the its size in bytes.
+
+A `null` string is represented as a single byte 0xFF.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.InvalidOperationException">Builder is not writable, it has been linked with another one.</exception>
       </Docs>
     </Member>
@@ -1537,7 +1571,19 @@
       <Docs>
         <param name="value">To be added.</param>
         <summary>Writes a string in User String (#US) heap format (see ECMA-335-II 24.2.4 #US and #Blob heaps).</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The string is UTF16 encoded and prefixed by the its size in bytes.
+
+This final byte holds the value 1 if and only if any UTF16 character within the string has any bit set in its top byte, or its low byte is any of the following: 0x01-0x08, 0x0E-0x1F, 0x27, 0x2D, 0x7F. Otherwise, it holds 0.
+
+The 1 signifies Unicode characters that require handling beyond that normally provided for 8-bit encoding sets.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.InvalidOperationException">Builder is not writable, it has been linked with another one.</exception>
       </Docs>
     </Member>
diff --git a/xml/System.Reflection.Metadata/BlobReader.xml b/xml/System.Reflection.Metadata/BlobReader.xml
index 69a64ec36f8..a42ad2a1673 100644
--- a/xml/System.Reflection.Metadata/BlobReader.xml
+++ b/xml/System.Reflection.Metadata/BlobReader.xml
@@ -134,7 +134,15 @@
         <param name="value">The byte value to find.</param>
         <summary>Searches for a specified byte in the blob following the current position.</summary>
         <returns>The index relative to the current position, or -1 if the byte is not found in the blob following the current position.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Doesn't change the current position.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -217,7 +225,15 @@
       <Docs>
         <summary>Reads a Blob heap handle encoded as a compressed integer.</summary>
         <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Blobs that contain references to other blobs are used in Portable PDB format, for example <xref:System.Reflection.Metadata.Document.Name>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="ReadBoolean">
@@ -503,7 +519,18 @@
       <Docs>
         <summary>Reads a <see cref="T:System.Decimal" /> number.</summary>
         <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Decimal number is encoded in 13 bytes as follows:
+
+ - byte 0: highest bit indicates sign (1 for negative, 0 for non-negative); the remaining 7 bits encode scale.
+ - bytes 1..12: 96-bit unsigned integer in little endian encoding.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.BadImageFormatException">The data at the current position was not a valid <see cref="T:System.Decimal" /> number.</exception>
       </Docs>
     </Member>
@@ -720,7 +747,15 @@
       <Docs>
         <summary>Reads a string encoded as a compressed integer containing its length followed by its contents in UTF8. Null strings are encoded as a single 0xFF byte.</summary>
         <returns>A string value, or <see langword="null" />.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Defined as a 'SerString' in the ECMA CLI specification.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.BadImageFormatException">The encoding is invalid.</exception>
       </Docs>
     </Member>
diff --git a/xml/System.Reflection.Metadata/BlobWriter.xml b/xml/System.Reflection.Metadata/BlobWriter.xml
index afb5a848c5a..0ca390754fb 100644
--- a/xml/System.Reflection.Metadata/BlobWriter.xml
+++ b/xml/System.Reflection.Metadata/BlobWriter.xml
@@ -764,7 +764,19 @@
       <Docs>
         <param name="value">To be added.</param>
         <summary>Implements compressed unsigned integer encoding as defined by ECMA-335-II chapter 23.2: Blobs and signatures.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the value lies between 0 (0x00) and 127 (0x7F), inclusive, encode as a one-byte integer (bit 7 is clear, value held in bits 6 through 0).
+
+If the value lies between 28 (0x80) and 214 - 1 (0x3FFF), inclusive, encode as a 2-byte integer with bit 15 set, bit 14 clear (value held in bits 13 through 0).
+
+Otherwise, encode as a 4-byte integer, with bit 31 set, bit 30 set, bit 29 clear (value held in bits 28 through 0).
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="value" /> can't be represented as a compressed unsigned integer.</exception>
       </Docs>
@@ -793,7 +805,19 @@
       <Docs>
         <param name="value">To be added.</param>
         <summary>Implements compressed signed integer encoding as defined by ECMA-335-II chapter 23.2: Blobs and signatures.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+If the value lies between -64 (0xFFFFFFC0) and 63 (0x3F), inclusive, encode as a one-byte integer: bit 7 clear, value bits 5 through 0 held in bits 6 through 1, sign bit (value bit 31) in bit 0.
+
+If the value lies between -8192 (0xFFFFE000) and 8191 (0x1FFF), inclusive, encode as a two-byte integer: 15 set, bit 14 clear, value bits 12 through 0 held in bits 13 through 1, sign bit(value bit 31) in bit 0.
+
+If the value lies between -268435456 (0xF000000) and 268435455 (0x0FFFFFFF), inclusive, encode as a four-byte integer: 31 set, 30 set, bit 29 clear, value bits 27 through 0 held in bits 28 through 1, sign bit(value bit 31) in bit 0.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="value" /> can't be represented as a compressed signed integer.</exception>
       </Docs>
@@ -1151,7 +1175,17 @@
       <Docs>
         <param name="str">To be added.</param>
         <summary>Writes a string in SerString format (see ECMA-335-II 23.3 Custom attributes).</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The string is UTF8 encoded and prefixed by the its size in bytes.
+
+A `null` string is represented as a single byte 0xFF.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.InvalidOperationException">The builder is not writable; it has been linked with another one.</exception>
       </Docs>
     </Member>
@@ -1341,7 +1375,19 @@
       <Docs>
         <param name="value">To be added.</param>
         <summary>Writes a string in User String (#US) heap format (see ECMA-335-II 24.2.4 #US and #Blob heaps).</summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The string is UTF16 encoded and prefixed by the its size in bytes.
+
+This final byte holds the value 1 if and only if any UTF16 character within the string has any bit set in its top byte, or its low byte is any of the following: 0x01-0x08, 0x0E-0x1F, 0x27, 0x2D, 0x7F. Otherwise, it holds 0.
+
+The 1 signifies Unicode characters that require handling beyond that normally provided for 8-bit encoding sets.
+
+          ]]></format>
+        </remarks>
         <exception cref="T:System.InvalidOperationException">Builder is not writable, it has been linked with another one.</exception>
       </Docs>
     </Member>
diff --git a/xml/System.Reflection.Metadata/Constant.xml b/xml/System.Reflection.Metadata/Constant.xml
index c83a4cafafa..0c9403b764d 100644
--- a/xml/System.Reflection.Metadata/Constant.xml
+++ b/xml/System.Reflection.Metadata/Constant.xml
@@ -51,7 +51,15 @@
       <Docs>
         <summary>Gets the parent handle (<see cref="T:System.Reflection.Metadata.ParameterHandle" />, <see cref="T:System.Reflection.Metadata.FieldDefinitionHandle" />, or <see cref="T:System.Reflection.Metadata.PropertyDefinitionHandle" />).</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Parent` field of the `Constant` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="TypeCode">
@@ -77,7 +85,15 @@
       <Docs>
         <summary>Gets a type code that identifies the type of the constant value.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Type` field of the `Constant` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -103,7 +119,15 @@
       <Docs>
         <summary>Gets the constant value.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Value` field of the `Constant` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Reflection.Metadata/CustomAttribute.xml b/xml/System.Reflection.Metadata/CustomAttribute.xml
index e32685a2387..879359c9492 100644
--- a/xml/System.Reflection.Metadata/CustomAttribute.xml
+++ b/xml/System.Reflection.Metadata/CustomAttribute.xml
@@ -51,7 +51,15 @@
       <Docs>
         <summary>Gets the constructor (the <see cref="T:System.Reflection.Metadata.MethodDefinitionHandle" /> or <see cref="T:System.Reflection.Metadata.MemberReferenceHandle" />) of the custom attribute type.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Type` field of the `CustomAttribute` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="DecodeValue&lt;TType&gt;">
@@ -109,7 +117,15 @@
       <Docs>
         <summary>Gets the handle of the metadata entity the attribute is applied to.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Parent` field of the `CustomAttribute` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Value">
@@ -135,7 +151,15 @@
       <Docs>
         <summary>Gets the value of the attribute.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Corresponds to the `Value` field of the `CustomAttribute` table in the ECMA-335 Standard.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Reflection.Metadata/Document.xml b/xml/System.Reflection.Metadata/Document.xml
index 4ac181de141..413ea1973c8 100644
--- a/xml/System.Reflection.Metadata/Document.xml
+++ b/xml/System.Reflection.Metadata/Document.xml
@@ -23,8 +23,16 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>The source document in the debug metadata.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information, see [Portable PDB v1.0: Format Specification](https://github.com/dotnet/corefx/blob/master/src/System.Reflection.Metadata/specs/PortablePdb-Metadata.md#document-table-0x30).
+
+      ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="Hash">
@@ -49,7 +57,17 @@
       <Docs>
         <summary>Gets the document content hash.</summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+<xref:System.Reflection.Metadata.Document.HashAlgorithm> determines the algorithm used to produce this hash.
+
+The source document is hashed in its binary form as stored in the file.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="HashAlgorithm">
diff --git a/xml/System.Reflection.Metadata/DocumentNameBlobHandle.xml b/xml/System.Reflection.Metadata/DocumentNameBlobHandle.xml
index 3226a17bc9d..9723cebff7f 100644
--- a/xml/System.Reflection.Metadata/DocumentNameBlobHandle.xml
+++ b/xml/System.Reflection.Metadata/DocumentNameBlobHandle.xml
@@ -27,8 +27,18 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>A <see cref="T:System.Reflection.Metadata.BlobHandle" /> representing a blob on #Blob heap in Portable PDB structured as Document Name.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The kind of the handle is <xref:System.Reflection.Metadata.HandleKind.Blob>.
+
+The handle is a specialization of <xref:System.Reflection.Metadata.BlobHandle> and doesn't have a distinct kind.
+
+      ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="Equals">