dotnet · mairaw · Dec 6, 2019 · Dec 5, 2019
diff --git a/xml/System.Reflection.Metadata/MetadataReader.xml b/xml/System.Reflection.Metadata/MetadataReader.xml
@@ -2169,8 +2169,8 @@ Use <xref:System.Reflection.Metadata.PEReaderExtensions.GetMetadataReader(System
         <ReturnType>System.Reflection.Metadata.MetadataReaderOptions</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the <see cref="F:System.Reflection.Metadata.MetadataReaderOptions" /> passed to the constructor.</summary>
-        <value>A bitwise combination of the enumeration values that describes the <see cref="F:System.Reflection.Metadata.MetadataReaderOptions" /> enum value.</value>
+        <summary>Gets the <see cref="T:System.Reflection.Metadata.MetadataReaderOptions" /> passed to the constructor.</summary>
+        <value>A bitwise combination of the enumeration values that describes the <see cref="T:System.Reflection.Metadata.MetadataReaderOptions" /> enum value.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Reflection.Metadata/SignatureHeader.xml b/xml/System.Reflection.Metadata/SignatureHeader.xml
@@ -288,9 +288,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="T:System.Reflection.Metadata.SignatureAttributes.ExplicitThis" /> signature attribute.</summary>
+        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="F:System.Reflection.Metadata.SignatureAttributes.ExplicitThis" /> signature attribute.</summary>
         <value>
-          <see langword="true" /> if the <see cref="T:System.Reflection.Metadata.SignatureAttributes.ExplicitThis" /> attribute is present; otherwise, <see langword="false" />.</value>
+          <see langword="true" /> if the <see cref="F:System.Reflection.Metadata.SignatureAttributes.ExplicitThis" /> attribute is present; otherwise, <see langword="false" />.</value>
         <remarks>
         </remarks>
       </Docs>
@@ -316,9 +316,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="T:System.Reflection.Metadata.SignatureAttributes.Generic" /> signature attribute.</summary>
+        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="F:System.Reflection.Metadata.SignatureAttributes.Generic" /> signature attribute.</summary>
         <value>
-          <see langword="true" /> if the <see cref="T:System.Reflection.Metadata.SignatureAttributes.Generic" /> attribute is present; otherwise, <see langword="false" />.</value>
+          <see langword="true" /> if the <see cref="F:System.Reflection.Metadata.SignatureAttributes.Generic" /> attribute is present; otherwise, <see langword="false" />.</value>
         <remarks>
         </remarks>
       </Docs>
@@ -344,9 +344,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="T:System.Reflection.Metadata.SignatureAttributes.Instance" /> signature attribute.</summary>
+        <summary>Gets a value that indicates whether this <see cref="T:System.Reflection.Metadata.SignatureHeader" /> structure has the <see cref="F:System.Reflection.Metadata.SignatureAttributes.Instance" /> signature attribute.</summary>
         <value>
-          <see langword="true" /> if the <see cref="T:System.Reflection.Metadata.SignatureAttributes.Instance" /> attribute is present; otherwise, <see langword="false" />.</value>
+          <see langword="true" /> if the <see cref="F:System.Reflection.Metadata.SignatureAttributes.Instance" /> attribute is present; otherwise, <see langword="false" />.</value>
         <remarks>
         </remarks>
       </Docs>

diff --git a/xml/System.Runtime.CompilerServices/Unsafe.xml b/xml/System.Runtime.CompilerServices/Unsafe.xml
@@ -985,8 +985,7 @@
         <typeparam name="T">The type of reference.</typeparam>
         <param name="source">The reference to subtract the offset from.</param>
         <param name="elementOffset">The offset to subtract.</param>
-        <summary>
-        Subtracts an element offset from the given reference.</summary>
+        <summary>Subtracts an element offset from the given reference.</summary>
         <returns>A new reference that reflects the subtraction of offset from pointer.</returns>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.Runtime.Serialization/XmlObjectSerializer.xml b/xml/System.Runtime.Serialization/XmlObjectSerializer.xml
@@ -45,8 +45,6 @@
 
  ]]></format>
     </remarks>
-    <exception cref="T:System.Runtime.Serialization.InvalidDataContractException">the type being serialized does not conform to data contract rules. For example, the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute has not been applied to the type.</exception>
-    <exception cref="T:System.Runtime.Serialization.SerializationException">there is a problem with the instance being serialized.</exception>
     <block subset="none" type="overrides">
       <para>When you inherit from <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />, you must override the following members: <see cref="M:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject(System.Xml.XmlDictionaryWriter,System.Object)" />, <see cref="M:System.Runtime.Serialization.XmlObjectSerializer.WriteObjectContent(System.Xml.XmlDictionaryWriter,System.Object)" />, <see cref="M:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject(System.Xml.XmlDictionaryWriter)" />. Additionally, the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject" /> and <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.ReadObject" /> methods must be implemented for reading and deserializing.</para>
     </block>

diff --git a/xml/System.Security.Cryptography/ECDiffieHellman.xml b/xml/System.Security.Cryptography/ECDiffieHellman.xml
@@ -305,8 +305,7 @@
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">
-          The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.
+        <exception cref="T:System.ArgumentException">The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.
 
 -or-
 
@@ -564,8 +563,7 @@ and callers are advised to call whichever method explicitly says it performs the
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">
-          The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
+        <exception cref="T:System.ArgumentException">The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="otherPartyPublicKey" /> is <see langword="null"/>.</exception>
         <exception cref="T:System.Security.Cryptography.CryptographicException">The curve used by <paramref name="otherPartyPublicKey" /> is different than the curve from this key.
@@ -624,8 +622,7 @@ For more information, see [IETF RFC 4346, section 5](https://tools.ietf.org/html
 ]]></format>
         </remarks>
         <exception cref="T:System.NotImplementedException">A derived class must override this method.</exception>
-        <exception cref="T:System.ArgumentException">
-          The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
+        <exception cref="T:System.ArgumentException">The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
         <exception cref="T:System.ArgumentNullException">
             <paramref name="otherPartyPublicKey"/>, <paramref name="prfLabel" /> or <paramref name="prfSeed" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Cryptography.CryptographicException">

diff --git a/xml/System.Security.Cryptography/ECDiffieHellmanCng.xml b/xml/System.Security.Cryptography/ECDiffieHellmanCng.xml
@@ -481,8 +481,7 @@ This instance represents only a public key.</exception>
         <returns>The first 48 bytes from the TLS 1.1 PRF, using the shared secret as the key.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.NotImplementedException">A derived class must override this method.</exception>
-        <exception cref="T:System.ArgumentException">
-          The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
+        <exception cref="T:System.ArgumentException">The curve used by <paramref name="otherPartyPublicKey" /> has a different size than the curve from this key.</exception>
         <exception cref="T:System.ArgumentNullException">
             <paramref name="otherPartyPublicKey"/>, <paramref name="prfLabel" /> or <paramref name="prfSeed" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.Cryptography.CryptographicException">

diff --git a/xml/System.Text/UTF32Encoding.xml b/xml/System.Text/UTF32Encoding.xml
@@ -1729,7 +1729,7 @@
 
  <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
         <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
-        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for a complete explanation)  
+        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for a complete explanation).
 
  -and-  
 

diff --git a/xml/System.Text/UTF7Encoding.xml b/xml/System.Text/UTF7Encoding.xml
@@ -318,7 +318,7 @@
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 
@@ -570,7 +570,7 @@
           <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 
@@ -670,7 +670,7 @@
  <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 
@@ -771,7 +771,7 @@
  <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 
@@ -854,7 +854,7 @@
  -or-  
 
  The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
-        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 
@@ -1539,7 +1539,7 @@
  -or-  
 
  <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
-        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for fuller explanation)  
+        <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for fuller explanation).
 
  -and-  
 

diff --git a/xml/System.Text/UTF8Encoding.xml b/xml/System.Text/UTF8Encoding.xml
@@ -393,7 +393,7 @@
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for complete explanation)
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for complete explanation).
 
  -and-  
 
@@ -544,7 +544,7 @@
 
  The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
         <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
-        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see [Character Encoding in the .NET Framework](~/docs/standard/base-types/character-encoding.md) for a complete explanation)  
+        <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see <see href="~/docs/standard/base-types/character-encoding.md">Character Encoding in .NET</see> for a complete explanation).
 
  -and-  
 

diff --git a/xml/System.Xml.Serialization/XmlSchemaExporter.xml b/xml/System.Xml.Serialization/XmlSchemaExporter.xml
@@ -134,9 +134,9 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="ns">The namespace of the XML schema document to which to add an **&lt;any&gt;** element.</param>
-        <summary>Exports an **&lt;any&gt;** element to the <see cref="T:System.Xml.Schema.XmlSchema" /> object that is identified by the specified namespace.</summary>
-        <returns>An arbitrary name assigned to the **&lt;any&gt;** element declaration.</returns>
+        <param name="ns">The namespace of the XML schema document to which to add an <c>&lt;any&gt;</c> element.</param>
+        <summary>Exports an <c>&lt;any&gt;</c> element to the <see cref="T:System.Xml.Schema.XmlSchema" /> object that is identified by the specified namespace.</summary>
+        <returns>An arbitrary name assigned to the <c>&lt;any&gt;</c> element declaration.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
 

diff --git a/xml/System.Xml.Serialization/XmlSerializationReader.xml b/xml/System.Xml.Serialization/XmlSerializationReader.xml
@@ -1761,7 +1761,7 @@
       <Docs>
         <summary>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the current XML element if the element has a null attribute with the value true.</summary>
         <returns>
-          <see langword="true" /> if the element has a **null="true"** attribute value and has been read; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if the element has a <c>null="true"</c> attribute value and has been read; otherwise, <see langword="false" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
 
@@ -1804,7 +1804,7 @@
       <Parameters />
       <Docs>
         <summary>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the fully qualified name of the element where it is currently positioned.</summary>
-        <returns>A <see cref="T:System.Xml.XmlQualifiedName" /> that represents the fully qualified name of the current XML element; otherwise, <see langword="null" /> if a **null="true"** attribute value is present.</returns>
+        <returns>A <see cref="T:System.Xml.XmlQualifiedName" /> that represents the fully qualified name of the current XML element; otherwise, <see langword="null" /> if a <c>null="true"</c> attribute value is present.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[