markdig fixes - Part 10 (#2687)

mairaw · Ron Petrusha · web-flow · commit dcb650ea0b81 · 2019-07-05T10:19:40.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.IdentityModel.Tokens/SessionSecurityTokenHandler.xml b/xml/System.IdentityModel.Tokens/SessionSecurityTokenHandler.xml
@@ -482,7 +482,11 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The following type URIs are supported: "http://schemas.microsoft.com/ws/2006/05/servicemodel/tokens/SecureConversation", "http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/sct", and "http://schemas.xmlsoap.org/ws/2005/02/sc/sct".  
+ The following type URIs are supported: 
+ 
+ - `http://schemas.microsoft.com/ws/2006/05/servicemodel/tokens/SecureConversation`
+ - `http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/sct`
+ - `http://schemas.xmlsoap.org/ws/2005/02/sc/sct`.  
   
  ]]></format>
         </remarks>
diff --git a/xml/System.Net/HttpWebRequest.xml b/xml/System.Net/HttpWebRequest.xml
@@ -103,7 +103,7 @@
    
   
 ## Examples  
- The following code example creates an <xref:System.Net.HttpWebRequest> for the URI http://www.contoso.com/.  
+ The following code example creates an <xref:System.Net.HttpWebRequest> for the URI `http://www.contoso.com/`.  
   
  [!code-cpp[Classic HttpWebRequest Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic HttpWebRequest Example/CPP/source.cpp#1)]
  [!code-csharp[Classic HttpWebRequest Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic HttpWebRequest Example/CS/source.cs#1)]
diff --git a/xml/System.Net/WebProxy.xml b/xml/System.Net/WebProxy.xml
@@ -861,7 +861,7 @@
 ## Remarks  
  The setting of the <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> property determines whether <xref:System.Net.WebRequest> instances use the proxy server when accessing local Internet resources.  
   
- If <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `true`, requests to local Internet resources do not use the proxy server. Local requests are identified by the lack of a period (.) in the URI, as in http://webserver/, or access the local server, including http://localhost, http://loopback, or http://127.0.0.1. When <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `false`, all Internet requests are made through the proxy server.  
+ If <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `true`, requests to local Internet resources do not use the proxy server. Local requests are identified by the lack of a period (.) in the URI, as in `http://webserver/`, or access the local server, including `http://localhost`, `http://loopback`, or `http://127.0.0.1`. When <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `false`, all Internet requests are made through the proxy server.  
   
 > [!NOTE]
 >  Requests to a local host with a URI that contain a period use the proxy. To avoid using a proxy in these cases, create an entry for the host in the <xref:System.Net.WebProxy.BypassList%2A>.  
@@ -1183,7 +1183,7 @@
   
  <xref:System.Net.WebProxy.IsBypassed%2A> returns `true` under any of the following conditions:  
   
--   If <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `true` and `host` is a local URI. Local requests are identified by the lack of a period (.) in the URI, as in "http://webserver/".  
+-   If <xref:System.Net.WebProxy.BypassProxyOnLocal%2A> is `true` and `host` is a local URI. Local requests are identified by the lack of a period (.) in the URI, as in `http://webserver/`.  
   
 -   If `host` matches a regular expression in <xref:System.Net.WebProxy.BypassList%2A>.  
   
diff --git a/xml/System/ApplicationIdentity.xml b/xml/System/ApplicationIdentity.xml
@@ -187,9 +187,9 @@ http://testserver/ActivationContext/ActivationContext.application
 ## Remarks  
  The following are two examples of <xref:System.ApplicationIdentity.CodeBase%2A> property values for an application named ActivationContext:  
   
--   http://testserver/ActivationContext/ActivationContext.application  
+- `http://testserver/ActivationContext/ActivationContext.application`  
   
--   file://C:/UserFiles/UserName/SolutionName/ActivationContext/publish/ActivationContext.application.  
+- `file://C:/UserFiles/UserName/SolutionName/ActivationContext/publish/ActivationContext.application`.  
   
    
   
diff --git a/xml/System/Decimal.xml b/xml/System/Decimal.xml
@@ -4695,7 +4695,7 @@
 |<xref:System.Globalization.NumberStyles.AllowThousands>|The *,* element.|  
 |<xref:System.Globalization.NumberStyles.AllowCurrencySymbol>|The *$* element.|  
 |<xref:System.Globalization.NumberStyles.Currency>|All. The `s` parameter cannot represent a hexadecimal number or a number in exponential notation.|  
-|<xref:System.Globalization.NumberStyles.Float>|The *ws* element at the beginning or end of `s`, *sign* at the beginning of `s`, and the *.*symbol. The `s` parameter can also use exponential notation.|  
+|<xref:System.Globalization.NumberStyles.Float>|The *ws* element at the beginning or end of `s`, *sign* at the beginning of `s`, and the *.* symbol. The `s` parameter can also use exponential notation.|  
 |<xref:System.Globalization.NumberStyles.Number>|The `ws`, `sign`, *,*, and *.* elements.|  
 |<xref:System.Globalization.NumberStyles.Any>|All styles, except `s` cannot represent a hexadecimal number.|  
   
diff --git a/xml/System/String.xml b/xml/System/String.xml
@@ -5791,7 +5791,9 @@ This method uses the [composite formatting feature](~/docs/standard/base-types/c
 [!INCLUDE[provider-string-format](~/includes/provider-string-format.md)]
 
 <a name="culture-sensitive-formatting" /> 
-## Example: Culture-sensitive formatting  
+
+### Example: Culture-sensitive formatting
+
  This example uses the <xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29> method to display the string representation of some date and time values and numeric values by using several different cultures.  
   
  [!code-csharp-interactive[System.String.Format2#2](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.String.Format2/cs/Example2.cs#2)]
diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml
@@ -477,7 +477,7 @@ Uri uri2 = new Uri("file:///C:/test/path/file.txt") // Explicit file path.
    
   
 ## Examples  
- The following example creates a <xref:System.Uri> instance for the URI http://www.contoso.com/Hello%20World.htm. Because the contained URI is completely escaped and is in canonical form, the `dontEscape` parameter can be set to `true`.  
+ The following example creates a <xref:System.Uri> instance for the URI `http://www.contoso.com/Hello%20World.htm`. Because the contained URI is completely escaped and is in canonical form, the `dontEscape` parameter can be set to `true`.  
   
  [!code-cpp[Classic Uri.Uri1 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic Uri.Uri1 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic Uri.Uri1 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic Uri.Uri1 Example/CS/source.cs#1)]
@@ -701,7 +701,7 @@ Uri uri2 = new Uri("file:///C:/test/path/file.txt") // Explicit file path.
    
   
 ## Examples  
- The following example creates a new instance of the <xref:System.Uri> class by combining the relative URIs http://www.contoso.com and catalog/shownew.htm to form the absolute URI http://www.contoso.com/catalog/shownew.htm.  
+ The following example creates a new instance of the <xref:System.Uri> class by combining the relative URIs `http://www.contoso.com` and `catalog/shownew.htm` to form the absolute URI `http://www.contoso.com/catalog/shownew.htm`.  
   
  [!code-cpp[Classic Uri.Uri3 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic Uri.Uri3 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic Uri.Uri3 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic Uri.Uri3 Example/CS/source.cs#1)]
@@ -1112,7 +1112,7 @@ Uri uri2 = new Uri("file:///C:/test/path/file.txt") // Explicit file path.
    
   
 ## Examples  
- The following example writes the complete contents of the <xref:System.Uri> instance to the console. In the example shown, http://www.contoso.com/catalog/shownew.htm?date=today is written to the console.  
+ The following example writes the complete contents of the <xref:System.Uri> instance to the console. In the example shown, `http://www.contoso.com/catalog/shownew.htm?date=today` is written to the console.  
   
  [!code-cpp[Classic Uri.AbsoluteUri Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic Uri.AbsoluteUri Example/CPP/source.cpp#1)]
  [!code-csharp[Classic Uri.AbsoluteUri Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic Uri.AbsoluteUri Example/CS/source.cs#1)]
@@ -1609,7 +1609,7 @@ If you used an escaped string to construct this instance (for example, "http://[
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Uri.Equals%2A> method compares the two instances without regard to user information (<xref:System.Uri.UserInfo%2A>) and fragment (<xref:System.Uri.Fragment%2A>) parts that they might contain. For example, given the URIs http://www.contoso.com/index.htm#search and http://user:password@www.contoso.com/index.htm, the <xref:System.Uri.Equals%2A> method would return `true`.  
+ The <xref:System.Uri.Equals%2A> method compares the two instances without regard to user information (<xref:System.Uri.UserInfo%2A>) and fragment (<xref:System.Uri.Fragment%2A>) parts that they might contain. For example, given the URIs `http://www.contoso.com/index.htm#search` and `http://user:password@www.contoso.com/index.htm`, the <xref:System.Uri.Equals%2A> method would return `true`.  
   
  If one <xref:System.Uri> instance is formed with a Unicode host name and `comparand` parameter contains a <xref:System.Uri> instance or identifier that is formed with a host name that has the equivalent Punycode host name, then <xref:System.Uri.Equals%2A> returns `true` only if International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled. Punycode names contain only ASCII characters and always start with the xn-- prefix.  
   
@@ -1900,7 +1900,7 @@ If you used an escaped string to construct this instance (for example, "http://[
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Uri.Fragment%2A> property gets any text following a fragment marker (#) in the URI, including the fragment marker itself. Given the URI http://www.contoso.com/index.htm#main, the <xref:System.Uri.Fragment%2A> property would return #main.  
+ The <xref:System.Uri.Fragment%2A> property gets any text following a fragment marker (#) in the URI, including the fragment marker itself. Given the URI `http://www.contoso.com/index.htm#main`, the <xref:System.Uri.Fragment%2A> property would return #main.  
   
  The <xref:System.Uri.Fragment%2A> property is not considered in any <xref:System.Uri.Equals%2A> comparison.  
   
@@ -3841,7 +3841,7 @@ If you used an escaped string to construct this instance (for example, "http://[
    
   
 ## Examples  
- The following example writes the scheme name (http) to the console for the http://www.contoso.com/ URI.  
+ The following example writes the scheme name (http) to the console for the `http://www.contoso.com/` URI.  
   
  [!code-cpp[Classic Uri.Scheme Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic Uri.Scheme Example/CPP/source.cpp#1)]
  [!code-csharp[Classic Uri.Scheme Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic Uri.Scheme Example/CS/source.cs#1)]
@@ -3940,7 +3940,7 @@ If you used an escaped string to construct this instance (for example, "http://[
  The following example shows the absolute path and segments for two URIs. The second example illustrates that the fragment and query are not part of the absolute path and therefore are not segments.  
   
  Absolute URI:  
- http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm  
+ `http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm`
   
  Absolute path:  
  /Chapters/Chapter1/Sections/Section1.htm  
@@ -3953,7 +3953,7 @@ If you used an escaped string to construct this instance (for example, "http://[
  - Section1.htm  
   
  Absolute URI:  
- http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm#page1?answer=NO  
+ `http://www.contoso.com/Chapters/Chapter1/Sections/Section1.htm#page1?answer=NO`
   
  Absolute path:  
  /Chapters/Chapter1/Sections/Section1.htm  
@@ -4901,4 +4901,4 @@ If you used an escaped string to construct this instance (for example, "http://[
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System/UriBuilder.xml b/xml/System/UriBuilder.xml
@@ -265,7 +265,7 @@
    
   
 ## Examples  
- The following example creates a <xref:System.UriBuilder> instance that contains the URI http://www.contoso.com/.  
+ The following example creates a <xref:System.UriBuilder> instance that contains the URI `http://www.contoso.com/`.  
   
  [!code-cpp[Classic UriBuilder.UriBuilder3 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder3 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic UriBuilder.UriBuilder3 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder3 Example/CS/source.cs#1)]
@@ -324,7 +324,7 @@
    
   
 ## Examples  
- The following example creates a <xref:System.UriBuilder> instance that contains the URI http://www.contoso.com:8080/.  
+ The following example creates a <xref:System.UriBuilder> instance that contains the URI `http://www.contoso.com:8080/`.  
   
  [!code-cpp[Classic UriBuilder.UriBuilder4 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder4 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic UriBuilder.UriBuilder4 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder4 Example/CS/source.cs#1)]
@@ -387,7 +387,7 @@
    
   
 ## Examples  
- The following example creates a <xref:System.UriBuilder> instance that contains the URI http://www.contoso.com:8080/index.htm.  
+ The following example creates a <xref:System.UriBuilder> instance that contains the URI `http://www.contoso.com:8080/index.htm`.  
   
  [!code-cpp[Classic UriBuilder.UriBuilder5 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder5 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic UriBuilder.UriBuilder5 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder5 Example/CS/source.cs#1)]
@@ -452,7 +452,7 @@
    
   
 ## Examples  
- The following example creates a <xref:System.UriBuilder> instance that contains the URI http://www.contoso.com:8080/index.htm#top.  
+ The following example creates a <xref:System.UriBuilder> instance that contains the URI `http://www.contoso.com:8080/index.htm#top`.  
   
  [!code-cpp[Classic UriBuilder.UriBuilder6 Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder6 Example/CPP/source.cpp#1)]
  [!code-csharp[Classic UriBuilder.UriBuilder6 Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UriBuilder.UriBuilder6 Example/CS/source.cs#1)]
@@ -565,7 +565,7 @@
    
   
 ## Examples  
- The following example creates the URI "http://www.contoso.com/index.htm#main".  
+ The following example creates the URI `"http://www.contoso.com/index.htm#main"`.  
   
  [!code-cpp[Classic UriBuilder.Fragment Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UriBuilder.Fragment Example/CPP/source.cpp#1)]
  [!code-csharp[Classic UriBuilder.Fragment Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UriBuilder.Fragment Example/CS/source.cs#1)]
@@ -614,7 +614,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The hash code is generated without including any fragment. The URIs http://www.contoso.com/index.htm#search and http://www.contoso.com/index.htm generate the same hash code.  
+ The hash code is generated without including any fragment. The URIs `http://www.contoso.com/index.htm#search` and `http://www.contoso.com/index.htm` generate the same hash code.  
   
  The hash codes for <xref:System.Uri> A and B are guaranteed to be the same when A.Equals(B) is `true`.  
   
diff --git a/xml/System/UriTemplate.xml b/xml/System/UriTemplate.xml
@@ -142,15 +142,12 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- When the `ignoreTrailingSlash` is set to `true`, trailing slashes on the end of template are ignored when matching a candidate URI. For example, a template such as "http://www.microsoft.com/customer/" would match the following candidate URIs:  
+ When the `ignoreTrailingSlash` is set to `true`, trailing slashes on the end of template are ignored when matching a candidate URI. For example, a template such as `http://www.microsoft.com/customer/` would match the following candidate URIs:  
   
--   "http://www.microsoft.com/customer/"  
-  
--   "http://www.microsoft.com/customer"  
-  
--   "http://www.microsoft.com/customer/?wsdl"  
-  
--   "http://www.microsoft.com/customer?wsdl"  
+- `http://www.microsoft.com/customer/`  
+- `http://www.microsoft.com/customer`  
+- `http://www.microsoft.com/customer/?wsdl`  
+- `http://www.microsoft.com/customer?wsdl`
   
  ]]></format>
         </remarks>
diff --git a/xml/ns-System.Xml.xml b/xml/ns-System.Xml.xml
@@ -159,7 +159,7 @@
 </xs:schema>  
 ```  
   
- If you try to validate the following XML against the schema above, the validation will fail with the following exception: "Unhandled Exception: System.Xml.Schema.XmlSchemaValidationException: The 'e2' el element is invalid - The value 'abc' is invalid according to its datatype 'http://www.w3.org/2001/XMLSchema:int' - The string 'abc' is not a valid Int32 value."
+ If you try to validate the following XML against the schema above, the validation will fail with the following exception: "Unhandled Exception: System.Xml.Schema.XmlSchemaValidationException: The 'e2' el element is invalid - The value 'abc' is invalid according to its datatype `'http://www.w3.org/2001/XMLSchema:int'` - The string 'abc' is not a valid Int32 value."
   
 ```xml  
 <e3><e2>abc</e2></e3>  
