markdig fixes - Part 11 (#2688)

mairaw · Ron Petrusha · web-flow · commit 8078fec57586 · 2019-07-03T17:20:32.000-07:00
* markdig fixes

* Apply suggestions from peer review

Co-Authored-By: Ron Petrusha &lt;ronpet@microsoft.com&gt;
diff --git a/xml/System.Reflection/MetadataLoadContext.xml b/xml/System.Reflection/MetadataLoadContext.xml
@@ -95,14 +95,14 @@ The core assembly is not loaded until necessary. The following APIs do not trigg
 * <xref:System.Reflection.MetadataLoadContext.LoadFromStream%2A?displayProperty=nameWithType>
 * <xref:System.Reflection.MetadataLoadContext.LoadFromAssemblyPath%2A?displayProperty=nameWithType>
 * <xref:System.Reflection.MetadataLoadContext.LoadFromByteArray%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetName%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.FullName?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetReferencedAssemblies%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetTypes%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.DefinedTypes?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetExportedTypes%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetForwardedTypes%2A?displayProperty=nameWithType>
-* <System.Reflection.Assembly.GetType(System.String,System.Boolean,System.Boolean)?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetName%2A?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.FullName?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetReferencedAssemblies%2A?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetTypes%2A?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.DefinedTypes?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetExportedTypes%2A?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetForwardedTypes%2A?displayProperty=nameWithType>
+* <xref:System.Reflection.Assembly.GetType(System.String,System.Boolean,System.Boolean)?displayProperty=nameWithType>
 * <xref:System.Type.Name?displayProperty=nameWithType>
 * <xref:System.Type.FullName?displayProperty=nameWithType>
 * <xref:System.Type.AssemblyQualifiedName?displayProperty=nameWithType>
@@ -111,11 +111,11 @@ If a core assembly cannot be found or if the core assembly is missing types, thi
             
 * APIs that need to parse signatures or typespecs and return the results as <xref:System.Type> objects will throw an exception. For example:
 
- * <xref:System.Reflection.MethodInfo.ReturnType?displayProperty=nameWithType>
- * System.Reflection.MethodBase.GetParameters%2A?displayProperty=nameWithType>
- * <xref:System.Type.BaseType?displayProperty-nameWithType>
- * <xref:System.Type.GetInterfaces%2A?displayProperty=nameWithType>
-            
+  * <xref:System.Reflection.MethodInfo.ReturnType?displayProperty=nameWithType>
+  * <xref:System.Reflection.MethodBase.GetParameters%2A?displayProperty=nameWithType>
+  * <xref:System.Type.BaseType?displayProperty-nameWithType>
+  * <xref:System.Type.GetInterfaces%2A?displayProperty=nameWithType>
+
 * APIs that need to compare types to well-known core types will not throw an exception, and the comparison will evaluate to `false`. For example, if you do not specify a core assembly, <xref:System.Type.IsPrimitive> will return `false` for everything, even types named <xref:System.Int32>. Similarly, <xref:System.Type.GetTypeCode%2A?displayProperty=nameWithType> will return <xref:System.TypeCode.Object> for everything.
             
 * If a metadata entity sets flags that surface as a pseudo-custom attribute, and the core assembly does not contain the pseudo-custom attribute type, the necessary constructor or any of the parameter types of the constructor, the <xref:System.Reflection.MetadataLoadContext> will not throw. It will omit the pseudo-custom attribute from the list of returned attributes.
@@ -233,7 +233,9 @@ Note that the behavior of this method matches the behavior of the <xref:System.R
         <remarks>
           <format type="text/markdown"><![CDATA[
 ## Remarks
-Note that the behavior of this method matches the behavior of <xref:System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyName%2A?displayProperty=nameWithType> resolve event but does not match the behavior of <xxref:System.Reflection.Assembly.ReflectionOnlyLoad%2A?displayProperty=nameWithType>. (The latter gives up without raising its resolve event.)
+
+Note that the behavior of this method matches the behavior of the <xref:System.Runtime.Loader.AssemblyLoadContext.LoadFromAssemblyName%2A?displayProperty=nameWithType> resolve event but does not match the behavior of <xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A?displayProperty=nameWithType>. (The latter gives up without raising its resolve event.)
+
 ]]></format>
         </remarks>
         <exception cref="T:System.IO.FileNotFoundException">The resolver returns <see langword="null" />.</exception>
@@ -325,4 +327,4 @@ Note that the behavior of this method matches the behavior of <xref:System.Runti
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml b/xml/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml
@@ -42,7 +42,7 @@
    
   
 ## Examples  
- This section contains two code examples. The first example demonstrates how to sign non-XML data using a detached signature.  Example #1 creates a signature of www.microsoft.com in an XML file and then verifies the file.  The second example demonstrates how to call members of the <xref:System.Security.Cryptography.Xml.XmlDsigC14NTransform> class.  
+ This section contains two code examples. The first example demonstrates how to sign non-XML data using a detached signature. Example #1 creates a signature of `www.microsoft.com` in an XML file and then verifies the file. The second example demonstrates how to call members of the <xref:System.Security.Cryptography.Xml.XmlDsigC14NTransform> class.  
   
  **Example #1**  
   
diff --git a/xml/System.Security.Permissions/SiteIdentityPermissionAttribute.xml b/xml/System.Security.Permissions/SiteIdentityPermissionAttribute.xml
@@ -42,9 +42,9 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Site identity is only defined for code from URLs with the protocols of HTTP, HTTPS, and FTP. A site is the string between the "//" after the protocol of a URL and the following "/", if present, for example, www.fourthcoffee.com in the URL http://www.fourthcoffee.com/process/grind.htm. This excludes port numbers. If a given URL is http://www.fourthcoffee.com:8000/, the site is www.fourthcoffee.com, not www.fourthcoffee.com:8000.  
+ Site identity is only defined for code from URLs with the protocols of HTTP, HTTPS, and FTP. A site is the string between the "//" after the protocol of a URL and the following "/", if present, for example, `www.fourthcoffee.com` in the URL `http://www.fourthcoffee.com/process/grind.htm`. This excludes port numbers. If a given URL is `http://www.fourthcoffee.com:8000/`, the site is `www.fourthcoffee.com`, not `www.fourthcoffee.com:8000`.  
   
- Sites can be matched exactly, or by a wildcard ("*") prefix at the dot delimiter. For example, the site name string *.fourthcoffee.com matches fourthcoffee.com as well as www.fourthcoffee.com. Without a wildcard, the site name must be a precise match. The site name string * will match any site, but will not match code that has no site evidence.  
+ Sites can be matched exactly, or by a wildcard ("\*") prefix at the dot delimiter. For example, the site name string `*.fourthcoffee.com` matches `fourthcoffee.com` as well as `www.fourthcoffee.com`. Without a wildcard, the site name must be a precise match. The site name string \* will match any site, but will not match code that has no site evidence.  
   
 > [!IMPORTANT]
 >  Starting with the [!INCLUDE[net_v40_long](~/includes/net-v40-long-md.md)], identity permissions are not used.  
@@ -164,9 +164,9 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Site identity is only defined for code from URLs with the protocols of HTTP, HTTPS, and FTP. A site is the string between the "//" after the protocol of a URL and the following "/", if present, for example, www.fourthcoffee.com in the URL http://www.fourthcoffee.com/process/grind.htm. This excludes port numbers. If a given URL is http://www.fourthcoffee.com:8000/, the site is www.fourthcoffee.com, not www.fourthcoffee.com:8000.  
+ Site identity is only defined for code from URLs with the protocols of HTTP, HTTPS, and FTP. A site is the string between the "//" after the protocol of a URL and the following "/", if present, for example, `www.fourthcoffee.com` in the URL `http://www.fourthcoffee.com/process/grind.htm`. This excludes port numbers. If a given URL is `http://www.fourthcoffee.com:8000/`, the site is `www.fourthcoffee.com`, not `www.fourthcoffee.com:8000`.  
   
- Sites can be matched exactly, or by a wildcard ("*") prefix at the dot delimiter. For example, the site name string *.fourthcoffee.com matches fourthcoffee.com as well as www.fourthcoffee.com. Without a wildcard, the site name must be a precise match.  
+ Sites can be matched exactly, or by a wildcard ("\*") prefix at the dot delimiter. For example, the site name string `*.fourthcoffee.com` matches `fourthcoffee.com` as well as `www.fourthcoffee.com`. Without a wildcard, the site name must be a precise match.  
   
  ]]></format>
         </remarks>
diff --git a/xml/System.ServiceModel.Configuration/ComContractElement.xml b/xml/System.ServiceModel.Configuration/ComContractElement.xml
@@ -20,7 +20,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- COM+ integration service contracts are currently restricted to the "http://tempuri.org" namespace, and the contract name is derived from the supporting COM interface. You can, however, specify alternatives by using the `comContracts` section in the configuration file.  
+ COM+ integration service contracts are currently restricted to the `"http://tempuri.org"` namespace, and the contract name is derived from the supporting COM interface. You can, however, specify alternatives by using the `comContracts` section in the configuration file.  
   
    
   
diff --git a/xml/System.ServiceModel.Configuration/ComContractsSection.xml b/xml/System.ServiceModel.Configuration/ComContractsSection.xml
@@ -20,7 +20,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The COM+ integration service contracts are currently restricted to the "http://tempuri.org" namespace, and contract name is derived from the supporting COM interface. You can, however, specify alternatives by using the `comContracts` section in the configuration file. For example, you can use the following configuration to specify the namespace and contract name for a service contract  
+ The COM+ integration service contracts are currently restricted to the `"http://tempuri.org"` namespace, and contract name is derived from the supporting COM interface. You can, however, specify alternatives by using the `comContracts` section in the configuration file. For example, you can use the following configuration to specify the namespace and contract name for a service contract  
   
   
   
diff --git a/xml/System.ServiceModel/ServiceBehaviorAttribute.xml b/xml/System.ServiceModel/ServiceBehaviorAttribute.xml
@@ -126,7 +126,7 @@
   
 -   The <xref:System.ServiceModel.ServiceBehaviorAttribute.Name%2A> property is the name of the service type, without namespace or assembly information.  
   
--   The <xref:System.ServiceModel.ServiceBehaviorAttribute.Namespace%2A> property is "http://tempuri.org".  
+-   The <xref:System.ServiceModel.ServiceBehaviorAttribute.Namespace%2A> property is `"http://tempuri.org"`.  
   
 -   The <xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A> property is `true`.  
   
diff --git a/xml/System.ServiceModel/ServiceContractAttribute.xml b/xml/System.ServiceModel/ServiceContractAttribute.xml
@@ -377,7 +377,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the namespace of the <see langword="&lt;portType&gt;" /> element in Web Services Description Language (WSDL).</summary>
-        <value>The WSDL namespace of the <see langword="&lt;portType&gt;" /> element. The default value is "http://tempuri.org".</value>
+        <value>The WSDL namespace of the <see langword="&lt;portType&gt;" /> element. The default value is <c>"http://tempuri.org"</c>.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
diff --git a/xml/System.ServiceModel/WSDualHttpBinding.xml b/xml/System.ServiceModel/WSDualHttpBinding.xml
@@ -179,7 +179,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- An Internet resource is local if it has a local address. A local address is one that is on the same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".  
+ An Internet resource is local if it has a local address. A local address is one that is on the same computer, the local LAN or intranet, and is identified, syntactically, by the lack of a period (.), as in the URIs `http://webserver/` and `http://localhost/`.  
   
  Setting the <xref:System.ServiceModel.WSDualHttpBinding.BypassProxyOnLocal%2A> property determines whether endpoints configured with the <xref:System.ServiceModel.WSDualHttpBinding> use the proxy server when accessing local resources.  
   
@@ -953,4 +953,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.ServiceModel/WSHttpBindingBase.xml b/xml/System.ServiceModel/WSHttpBindingBase.xml
@@ -131,7 +131,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".  
+ An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet, and is identified, syntactically, by the lack of a period (.), as in the URIs `http://webserver/` and `http://localhost/`.  
   
  Setting the <xref:System.ServiceModel.WSHttpBindingBase.BypassProxyOnLocal%2A> property determines whether endpoints configured with the <xref:System.ServiceModel.WSHttpBindingBase> use the proxy server when accessing local resources.  
   
@@ -831,4 +831,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.ServiceModel/WebHttpBinding.xml b/xml/System.ServiceModel/WebHttpBinding.xml
@@ -233,7 +233,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet and is identified, syntactically, by the lack of a period (.) as in the URIs "http://webserver/" and "http://localhost/".  
+ An Internet resource is local if it has a local address. A local address is one that is on same computer, the local LAN or intranet, and is identified, syntactically, by the lack of a period (.), as in the URIs `http://webserver/` and `http://localhost/`.  
   
  Setting the <xref:System.ServiceModel.WebHttpBinding.BypassProxyOnLocal%2A> property determines whether endpoints configured with the <xref:System.ServiceModel.WebHttpBinding> use the proxy server when accessing local resources.  
   
@@ -834,4 +834,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
