markdig fixes - Part 5 (#2556)

mairaw · web-flow · commit c3e74ef58560 · 2019-06-06T17:45:05.000-07:00
* markdig fixes

* Apply suggestions from peer review

Co-Authored-By: Ron Petrusha &lt;ronpet@microsoft.com&gt;

* fix param name
diff --git a/xml/System.Data.Services.Common/EntityPropertyMappingAttribute.xml b/xml/System.Data.Services.Common/EntityPropertyMappingAttribute.xml
@@ -151,7 +151,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- When the value of <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.KeepInContent%2A> is `true`, the feed is backward compatible with [!INCLUDE[ssAstoria](~/includes/ssastoria-md.md)] client applications that use protocol version 1.0. When the value of <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.KeepInContent%2A>``is `false`, the protocol version used by the data service must be 2.0 or later versions. For more information, see [Data Service Versioning](~/docs/framework/data/wcf/data-service-versioning-wcf-data-services.md).  
+ When the value of <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.KeepInContent%2A> is `true`, the feed is backward compatible with [!INCLUDE[ssAstoria](~/includes/ssastoria-md.md)] client applications that use protocol version 1.0. When the value of <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.KeepInContent%2A> is `false`, the protocol version used by the data service must be 2.0 or later versions. For more information, see [Data Service Versioning](~/docs/framework/data/wcf/data-service-versioning-wcf-data-services.md).  
   
  ]]></format>
         </remarks>
diff --git a/xml/System.Net.PeerToPeer/PeerNameRecordCollection.xml b/xml/System.Net.PeerToPeer/PeerNameRecordCollection.xml
@@ -28,14 +28,11 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
-  
--   This collection holds instances of the <xref:System.Net.PeerToPeer.PeerNameRecord> element, which are used to specify information about a peer within a <xref:System.Net.PeerToPeer.Cloud>.  
-  
--  
-  
- References to a peer name record collection are returned by the <xref:System.Net.PeerToPeer.PeerNameResolver.Resolve%2A> and <xref:System.Net.PeerToPeer.PeerNameResolver.ResolveAsync%2A> methods.  
-  
- All members of the class are inherited from the Collection\<T> class.  Only those methods which are overridden are described.  
+
+This collection holds instances of the <xref:System.Net.PeerToPeer.PeerNameRecord> element, which are used to specify information about a peer within a <xref:System.Net.PeerToPeer.Cloud>.
+
+References to a peer name record collection are returned by the <xref:System.Net.PeerToPeer.PeerNameResolver.Resolve%2A?displayProperty=nameWithType> and <xref:System.Net.PeerToPeer.PeerNameResolver.ResolveAsync%2A?displayProperty=nameWithType> methods.
+
   
  ]]></format>
     </remarks>
@@ -142,4 +139,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.Net.PeerToPeer/PnrpPermission.xml b/xml/System.Net.PeerToPeer/PnrpPermission.xml
@@ -37,7 +37,7 @@
 ## Remarks  
  The default permissions allow all local and Intranet zone applications to access PNRP services. If the default permissions are not changed, all link-local and site-local applications have access to Peer-to-Peer services, but global (internet) applications have no access.  
   
- Instances of this type have two permission states: they either have no access to the resource(s) protected by the permission, or they have unrestricted full access to those resources.  
+ Instances of this type have two permission states: they either have no access to the resources protected by the permission, or they have unrestricted full access to those resources.  
   
  ]]></format>
     </remarks>
@@ -267,19 +267,18 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The current <xref:System.Net.PeerToPeer.PnrpPermission> is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission that represents access to "*C:\example.txt*" is a subset of a permission that represents access to "*C:\\*". If this method returns `true`, the current permission represents no more access to the protected resource than does the specified permission.  
-  
- The following statements are required to be `true` for all implementations of the IsSubsetOf method. X, Y, and Z represent <xref:System.Security.IPermission> objects that are not a `null` reference (`Nothing` in Visual Basic).  
-  
--   X.IsSubsetOf(X) returns `true`.  
-  
--   X.IsSubsetOf(Y) returns the same value as Y.IsSubsetOf(X) if and only if X and Y represent the same set of permissions.  
-  
--   If X.IsSubsetOf(Y) and Y.IsSubsetOf(Z) both return `true`, X.IsSubsetOf(Z) returns `true`.  
+
+The current <xref:System.Net.PeerToPeer.PnrpPermission> is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission that represents access to "*C:\example.txt*" is a subset of a permission that represents access to "*C:\\*". If this method returns `true`, the current permission represents no more access to the protected resource than does the specified permission.  
   
--  
+The following statements are required to be `true` for all implementations of the IsSubsetOf method. X, Y, and Z represent <xref:System.Security.IPermission> objects that are not a `null` reference (`Nothing` in Visual Basic).
+
+- `X.IsSubsetOf(X)` returns `true`.
+
+- `X.IsSubsetOf(Y)` returns the same value as `Y.IsSubsetOf(X)` if and only if X and Y represent the same set of permissions.
+
+- If `X.IsSubsetOf(Y)` and `Y.IsSubsetOf(Z)` both return `true`, `X.IsSubsetOf(Z)` returns `true`.
   
- If X represents an empty IPermission object with a permission state of *None* and Y represents an IPermission object that is a `null` reference (`Nothing` in Visual Basic), X.IsSubsetOf(Y) returns `true`. If Z is also an empty permission, the compound set operation X.Union(Z).IsSubsetOf(Y) also returns `true` because the <xref:System.Net.PeerToPeer.PnrpPermission.Union%2A> of two empty permissions is an empty permission.  
+If X represents an empty <xref:System.Security.IPermission> object with a permission state of *None*, and Y represents an <xref:System.Security.IPermission> object that is a `null` reference (`Nothing` in Visual Basic), `X.IsSubsetOf(Y)` returns `true`. If Z is also an empty permission, the compound set operation `X.Union(Z).IsSubsetOf(Y)` also returns `true` because the <xref:System.Net.PeerToPeer.PnrpPermission.Union%2A> of two empty permissions is an empty permission.
   
  ]]></format>
         </remarks>
@@ -417,4 +416,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.Security.Policy/Site.xml b/xml/System.Security.Policy/Site.xml
@@ -41,9 +41,10 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The presence of <xref:System.Security.Policy.Site> evidence produces a <xref:System.Security.Permissions.SiteIdentityPermission> in the grant set. If there is a <xref:System.Security.CodeAccessPermission.Demand%2A> for <xref:System.Security.Permissions.SiteIdentityPermission>, the <xref:System.Security.Permissions.SiteIdentityPermission> that corresponds to the <xref:System.Security.Policy.Site> evidence will be compared with the demanded permission.  
+
+The presence of <xref:System.Security.Policy.Site> evidence produces a <xref:System.Security.Permissions.SiteIdentityPermission> in the grant set. If there is a <xref:System.Security.CodeAccessPermission.Demand%2A> for <xref:System.Security.Permissions.SiteIdentityPermission>, the <xref:System.Security.Permissions.SiteIdentityPermission> that corresponds to the <xref:System.Security.Policy.Site> evidence will be compared with the demanded permission.  
   
- Site identity is defined for code from URLs with any protocol except FILE. A site is the string between the "//" after the protocol of a URL and the following "/", if present. For example, www.fourthcoffee.com is the site identity 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 defined for code from URLs with any protocol except FILE. A site is the string between the "//" after the protocol of a URL and the following "/", if present. For example, `www.fourthcoffee.com` is the site identity 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`.
   
  ]]></format>
     </remarks>
diff --git a/xml/System.Security.Policy/SiteMembershipCondition.xml b/xml/System.Security.Policy/SiteMembershipCondition.xml
@@ -46,9 +46,10 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- A code assembly satisfies a site membership condition if that code originates from the Web site specified by <xref:System.Security.Policy.SiteMembershipCondition.Site%2A>. Site identity is defined for code from URLs with any protocol except FILE. A site is the string between the "//" after the protocol of a URL and the following "/", if present. For example, www.fourthcoffee.com is the site identity 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.  
+
+A code assembly satisfies a site membership condition if that code originates from the Web site specified by <xref:System.Security.Policy.SiteMembershipCondition.Site%2A>. Site identity is defined for code from URLs with any protocol except FILE. A site is the string between the "//" after the protocol of a URL and the following "/", if present. For example, `www.fourthcoffee.com` is the site identity 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 *.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 * 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 `*.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 \* will match any site, but will not match code that has no site evidence.
   
  ]]></format>
     </remarks>
diff --git a/xml/System.Web.UI.Design/TemplateEditingVerb.xml b/xml/System.Web.UI.Design/TemplateEditingVerb.xml
@@ -211,20 +211,16 @@
   
  When `disposing` is `true`, this method releases all resources held by any managed objects that this <xref:System.Web.UI.Design.TemplateEditingVerb> references. This method invokes the `Dispose` method of each referenced object.  
   
- ]]></format>
-        </remarks>
-        <block subset="none" type="overrides">
-          <para>
-            <block subset="none" type="note">
-              <para>  
- The <see cref="T:System.Web.UI.Design.TemplateEditingVerb" /> class is obsolete. Expose templates through the <see cref="P:System.Web.UI.Design.ControlDesigner.TemplateGroups" /> property of a control designer. The design host creates a <see cref="T:System.Web.UI.Design.TemplatedEditableDesignerRegion" /> for each <see cref="T:System.Web.UI.Design.TemplateGroup" /> defined for a control designer.  
+## Notes to inheritors
+
+The <xref:System.Web.UI.Design.TemplateEditingVerb> class is obsolete. Expose templates through the <xref:System.Web.UI.Design.ControlDesigner.TemplateGroups> property of a control designer. The design host creates a <xref:System.Web.UI.Design.TemplatedEditableDesignerRegion> for each <xref:System.Web.UI.Design.TemplateGroup> defined for a control designer.
   
-</para>
-            </block>
-            <see langword="Dispose" /> can be called multiple times by other objects. When overriding <see langword="Dispose(Boolean)" />, be careful not to reference objects that have been previously disposed of in an earlier call to <see langword="Dispose" />. For more information about how to implement <see langword="Dispose(Boolean)" />, see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md).  
+`Dispose` can be called multiple times by other objects. When overriding `Dispose(Boolean)`, be careful not to reference objects that have been previously disposed of in an earlier call to `Dispose`. For more information about how to implement `Dispose(Boolean)`, see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md).
   
- For more information about <see langword="Dispose" /> and <see cref="M:System.Object.Finalize" />, see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).</para>
-        </block>
+For more information about `Dispose` and <xref:System.Object.Finalize>, see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).
+
+ ]]></format>
+        </remarks>
         <altmember cref="P:System.Web.UI.Design.ControlDesigner.TemplateGroups" />
         <altmember cref="T:System.Web.UI.Design.TemplatedEditableDesignerRegion" />
         <altmember cref="T:System.Web.UI.Design.TemplateGroup" />
diff --git a/xml/System.Web/HttpCookie.xml b/xml/System.Web/HttpCookie.xml
@@ -373,9 +373,8 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Web.HttpCookie.Path%2A> property extends the <xref:System.Web.HttpCookie.Domain%2A> property to completely describe the specific URL to which the cookie applies. For example, in the URL http:/www.microsoft.com/asp, the domain is www.microsoft.com and the path is /asp.  
-  
-   
+
+The <xref:System.Web.HttpCookie.Path%2A> property extends the <xref:System.Web.HttpCookie.Domain%2A> property to completely describe the specific URL to which the cookie applies. For example, in the URL `http:/www.microsoft.com/asp`, the domain is `www.microsoft.com` and the path is /asp.
   
 ## Examples  
  The following code example sets the <xref:System.Web.HttpCookie.Path%2A> property of a new cookie.  
diff --git a/xml/System.Workflow.ComponentModel/ActivityExecutionStatusChangedEventArgs.xml b/xml/System.Workflow.ComponentModel/ActivityExecutionStatusChangedEventArgs.xml
@@ -134,8 +134,6 @@
   
 -   The <xref:System.Workflow.ComponentModel.ActivityExecutionResult> as an enumeration converted to string, of the originating <xref:System.Workflow.ComponentModel.Activity>.  
   
--  
-  
  ]]></format>
         </remarks>
       </Docs>
diff --git a/xml/System.Xml.Serialization/XmlTypeMapping.xml b/xml/System.Xml.Serialization/XmlTypeMapping.xml
@@ -35,7 +35,7 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Xml.Serialization.XmlTypeMapping> class is used to serialize an object as encoded SOAP XML. The resulting XML conforms to section 5 of the World Wide Web Consortium (www.w3.org) document, "Simple Object Access Protocol (SOAP) 1.1". Create an <xref:System.Xml.Serialization.XmlTypeMapping> by calling the <xref:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping%2A> method of the <xref:System.Xml.Serialization.SoapReflectionImporter> class. Use the <xref:System.Xml.Serialization.XmlTypeMapping> to construct an instance of the <xref:System.Xml.Serialization.XmlSerializer> class. To control the serialization, use one of the attributes listed in [Attributes That Control Encoded SOAP Serialization](~/docs/standard/serialization/attributes-that-control-encoded-soap-serialization.md).  
+ The <xref:System.Xml.Serialization.XmlTypeMapping> class is used to serialize an object as encoded SOAP XML. The resulting XML conforms to section 5 of the [World Wide Web Consortium](https://www.w3.org) document, "Simple Object Access Protocol (SOAP) 1.1". Create an <xref:System.Xml.Serialization.XmlTypeMapping> by calling the <xref:System.Xml.Serialization.SoapReflectionImporter.ImportTypeMapping%2A> method of the <xref:System.Xml.Serialization.SoapReflectionImporter> class. Use the <xref:System.Xml.Serialization.XmlTypeMapping> to construct an instance of the <xref:System.Xml.Serialization.XmlSerializer> class. To control the serialization, use one of the attributes listed in [Attributes That Control Encoded SOAP Serialization](~/docs/standard/serialization/attributes-that-control-encoded-soap-serialization.md).  
   
    
   
@@ -323,4 +323,4 @@ To set a namespace name of an object, apply a <xref:System.Xml.Serialization.Soa
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml
@@ -4953,7 +4953,7 @@ The `DateTime.Parse` overloads return a <xref:System.DateTime> value whose <xref
  [!code-csharp-interactive[System.DateTime.Parse#5](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTime.Parse/cs/Parse5.cs#5)]
  [!code-vb[System.DateTime.Parse#5](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTime.Parse/vb/Parse5.vb#5)]  
   
-### Examples
+## Examples
 
 Numerous examples that call the `DateTime.Parse` method are interspersed throughout the [Remarks](#remarks) section of this article and in the documentation for the individual `DateTime.Parse` overloads.
 
