markdig fixes - Part 7 (#2564)

* markdig fixes - bare URLs

* Apply suggestions from peer review

Co-Authored-By: Ron Petrusha <[email protected]>

* feedback

Author: mairaw

xml/System.Security.Cryptography.Xml/KeyInfo.xml

@@ -35,7 +35,7 @@
   
  The <xref:System.Security.Cryptography.Xml.KeyInfo> class enables you to imbed key-related information intended to help identify the key necessary for validating or decrypting the XML document. Multiple types of key-related information can be included within a single <xref:System.Security.Cryptography.Xml.KeyInfo>; each type of key-related information has an associated class derived from <xref:System.Security.Cryptography.Xml.KeyInfoClause>.  
   
- For more information about the `<KeyInfo>` element, see the XMLDSIG specification, which is available from the W3C at www.w3.org/TR/xmldsig-core/, or see the XML encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<KeyInfo>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.
   
    
   

xml/System.Security.Cryptography.Xml/KeyInfoClause.xml

@@ -29,7 +29,7 @@
 ## Remarks  
  You can use <xref:System.Security.Cryptography.Xml.KeyInfoClause> objects to build a <xref:System.Security.Cryptography.Xml.KeyInfo> object for a specific digital signature or encrypted XML document. <xref:System.Security.Cryptography.Xml.KeyInfo> allows recipients of XML digital signatures and encrypted XML documents to determine which signing method and key values should be used for validation and decryption.  
   
- For more information about the <xref:System.Security.Cryptography.Xml.KeyInfo> element and its subelements, see the XMLDSIG specification, which is available from the W3C at www.w3.org/TR/xmldsig-core/, or see the XML encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the <xref:System.Security.Cryptography.Xml.KeyInfo> element and its subelements, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.
   
  ]]></format>
     </remarks>

xml/System.Security.Cryptography.Xml/KeyInfoName.xml

@@ -29,7 +29,7 @@
 ## Remarks  
  The `<KeyName>` element contains a string identifier that the party validating or decrypting an XML document uses to identify the corresponding key.  For example, if you receive an encrypted or signed XML document that has a `<KeyName>` element value of "AsymmetricKey1", you will use a key that you and the sender have named "AsymmetricKey1" to decrypt or verify the document.  Both parties must agree on a key name mapping ahead of time.  Note that the actual key is not imbedded in the XML document.  
   
- For more information about the `<KeyName>` element, see Section 4.4.1 of the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/, or see the XML Encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<KeyName>` element, see Section 4.4.1 of the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML Encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.  
   
    
   

xml/System.Security.Cryptography.Xml/KeyInfoNode.xml

@@ -29,7 +29,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.KeyInfo> subelements with specific implementations are <xref:System.Security.Cryptography.Xml.KeyInfoName>, <xref:System.Security.Cryptography.Xml.KeyInfoRetrievalMethod>, and <xref:System.Security.Cryptography.Xml.KeyInfoX509Data>.  
   
- For more information about the `<KeyInfo>` element, see Section 4.4 of the XMLDSIG specification, which is available from the W3C at www.w3.org/TR/xmldsig-core/, or see the XML Encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<KeyInfo>` element, see Section 4.4 of the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML Encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.  
   
  ]]></format>
     </remarks>

xml/System.Security.Cryptography.Xml/KeyInfoRetrievalMethod.xml

@@ -31,7 +31,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.KeyInfoRetrievalMethod> class to reference the same <xref:System.Security.Cryptography.Xml.KeyInfo> information in multiple XMLDSIG signatures or encrypted XML documents, especially when the referenced information is large. For example, a `<RetrievalMethod>` subelement can be used to reference a <xref:System.Security.Cryptography.Xml.KeyInfoX509Data> object that contains an X.509v3 certificate chain, which validates the signing key.  
   
- For more information about the `<RetrievalMethod>` element, see Section 4.4.3 of the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/, or see the XML Encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<RetrievalMethod>` element, see Section 4.4.3 of the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML Encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.  
   
  ]]></format>
     </remarks>

xml/System.Security.Cryptography.Xml/KeyInfoX509Data.xml

@@ -31,7 +31,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.KeyInfoX509Data> class whenever you need to include X.509 certificate data in an encrypted or signed XML document.  
   
- For more information about the `<X509Data>` element, see Section 4.4.4 of the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/, or see the XML Encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<X509Data>` element, see Section 4.4.4 of the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML Encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.  
   
    
   

xml/System.Security.Cryptography.Xml/SignedInfo.xml

@@ -34,11 +34,11 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Security.Cryptography.Xml.SignedInfo> class represents the <`SignedInfo`> element of an XML signature defined by the XML digital signature specification. The <`SignedInfo`> element, which is a subelement of the <`Signature`> element, contains the canonicalization method used for signing, the algorithm used for signing and validation, and references that describe a digital signature.  
+ The <xref:System.Security.Cryptography.Xml.SignedInfo> class represents the `<SignedInfo>` element of an XML signature defined by the XML digital signature specification. The `<SignedInfo>` element, which is a subelement of the `<Signature>` element, contains the canonicalization method used for signing, the algorithm used for signing and validation, and references that describe a digital signature.  
   
  For most scenarios, you should use the <xref:System.Security.Cryptography.Xml.SignedInfo> class available from the <xref:System.Security.Cryptography.Xml.SignedXml.SignedInfo%2A> property to sign and verify XML digital signatures.  
   
- For more information about the <`SignedInfo`> element, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<SignedInfo>` element, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
     </remarks>
@@ -138,7 +138,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Security.Cryptography.Xml.SignedInfo.CanonicalizationMethod%2A> property uses a string Uniform Resource Identifier (URI) to represent the <`Canonicalization`> element of an XML digital signature.  
+ The <xref:System.Security.Cryptography.Xml.SignedInfo.CanonicalizationMethod%2A> property uses a string Uniform Resource Identifier (URI) to represent the `<Canonicalization>` element of an XML digital signature.  
   
  Use the <xref:System.Security.Cryptography.Xml.SignedInfo.CanonicalizationMethod%2A> property to specify the canonicalization algorithm applied to the XML output of the <xref:System.Security.Cryptography.Xml.SignedInfo> class before performing signature calculations.  
   
@@ -151,7 +151,7 @@
 |Exclusive Canonical XML|<https://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/#WithComments><br /><br /> Also defined in the following static field: <xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigExcC14NTransformUrl>|  
 |Exclusive Canonical XML with comments|<https://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/#WithComments><br /><br /> Also defined in the following static field: <xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigExcC14NWithCommentsTransformUrl>|  
   
- For more information about XML digital signatures, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -532,7 +532,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedInfo.References%2A> property to describe the transforms, digest algorithms, and digest values of an XML digital signature.  
   
- For more information about XML digital signatures, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -652,4 +652,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Security.Cryptography.Xml/SignedXml.xml

@@ -355,7 +355,7 @@
   
  The <xref:System.Security.Cryptography.Xml.SignedXml.AddObject%2A> method internally calls the <xref:System.Security.Cryptography.Xml.Signature.AddObject%2A> method of the <xref:System.Security.Cryptography.Xml.Signature> object encapsulated by the <xref:System.Security.Cryptography.Xml.SignedXml> object.  You can also add a <xref:System.Security.Cryptography.Xml.DataObject> object by directly calling the <xref:System.Security.Cryptography.Xml.Signature.AddObject%2A> method from the <xref:System.Security.Cryptography.Xml.SignedXml.Signature%2A> property.  
   
- For more information about XML digital signatures, see the XMLDSIG specification available at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -406,7 +406,7 @@
   
  The <xref:System.Security.Cryptography.Xml.SignedXml.AddReference%2A> method internally calls the <xref:System.Security.Cryptography.Xml.SignedInfo.AddReference%2A> method of the <xref:System.Security.Cryptography.Xml.SignedInfo> object encapsulated by the <xref:System.Security.Cryptography.Xml.SignedXml> object.  You can also add a <xref:System.Security.Cryptography.Xml.Reference> object by directly calling the <xref:System.Security.Cryptography.Xml.SignedInfo.AddReference%2A> method from the <xref:System.Security.Cryptography.Xml.SignedXml.SignedInfo%2A> property.  
   
- For more information about XML digital signatures, see the XMLDSIG specification available at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -1076,7 +1076,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedXml.KeyInfo%2A> property to embed key-related information intended to help identify the key necessary for validating an XML document.  
   
- For more information about the `<KeyInfo>` element, see the XMLDSIG specification, which is available at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<KeyInfo>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -1311,7 +1311,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedXml.Signature%2A> property to retrieve the <xref:System.Security.Cryptography.Xml.Signature> object used by the <xref:System.Security.Cryptography.Xml.SignedXml> object.  
   
- For more information about the `<Signature>` element, see the XMLDSIG specification, which is available at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<Signature>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).
   
    
   
@@ -1436,7 +1436,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedXml.SignatureMethod%2A> property to retrieve the <`SignatureMethod`> URI used by the <xref:System.Security.Cryptography.Xml.SignedXml> object. This property is read only. For more information about programmatically specifying a URI for the <`SignatureMethod`> element, see the <xref:System.Security.Cryptography.Xml.SignedInfo.SignatureMethod%2A> property.  
   
- For more information about the `<SignatureMethod>` element, see the XMLDSIG specification, which is available at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<SignatureMethod>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -1476,7 +1476,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedXml.SignatureValue%2A> property to retrieve the value of the XML digital signature.  This property is automatically populated when you make a successful call to the <xref:System.Security.Cryptography.Xml.SignedXml.ComputeSignature%2A> method.  
   
- For more information about the `<SignatureValue>` element, see the XMLDSIG specification, which is available at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<SignatureValue>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -1516,7 +1516,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.SignedXml.SignedInfo%2A> property to retrieve the <xref:System.Security.Cryptography.Xml.SignedInfo> object that is used by the <xref:System.Security.Cryptography.Xml.SignedXml> object to create an XML digital signature.  
   
- For more information about the `<SignedInfo>` element, see the XMLDSIG specification, which is available at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<SignedInfo>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>

xml/System.Security.Cryptography.Xml/Transform.xml

@@ -31,7 +31,7 @@
   
  Use a class that derives from the <xref:System.Security.Cryptography.Xml.Transform> class whenever you need to add one or more transform objects to an encrypted XML document or to a signed XML document.  
   
- For more information about the `<Transform>` element, see the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/, or the XML encryption specification, which is available from the W3C at www.w3.org/TR/xmlenc-core/.  
+ For more information about the `<Transform>` element, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/) or the [XML encryption specification](https://www.w3.org/TR/xmlenc-core/), which are available on the W3C website.  
   
  ]]></format>
     </remarks>
@@ -92,7 +92,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This property corresponds to the <xref:System.Security.Cryptography.Xml.Transform.Algorithm%2A> attribute of a `<Transform>` element in an XMLDSIG signature. For example, the algorithm URI for the Base64 decoding transform is defined as http://www.w3.org/2000/09/xmldsig#base64 in the XMLDSIG specification (Section 6.6.2).  
+ This property corresponds to the <xref:System.Security.Cryptography.Xml.Transform.Algorithm%2A> attribute of a `<Transform>` element in an XMLDSIG signature. For example, the algorithm URI for the Base64 decoding transform is defined in the [XMLDSIG specification (Section 6.6.2)](https://www.w3.org/TR/xmldsig-core1/#sec-Base-64).  
   
  You can conveniently set this value using one of the static fields associated with the <xref:System.Security.Cryptography.Xml.SignedXml> class.  
   

xml/System.Windows.Forms/HtmlDocument.xml

@@ -536,7 +536,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- By default, two Web pages in different frames are prevented from accessing each other's content using script; even www.microsoft.com and msdn.microsoft.com are, in this instance, considered different domains. To enable cross-frame scripting for pages from the same top-level domain, you can assign a new value to the <xref:System.Windows.Forms.HtmlDocument.Domain%2A> property. In the pervious URL example, setting <xref:System.Windows.Forms.HtmlDocument.Domain%2A> to microsoft.com would allow both pages to communicate with one another.  
+ By default, two Web pages in different frames are prevented from accessing each other's content using script; even `www.microsoft.com` and `docs.microsoft.com` are, in this instance, considered different domains. To enable cross-frame scripting for pages from the same top-level domain, you can assign a new value to the <xref:System.Windows.Forms.HtmlDocument.Domain%2A> property. In the previous URL example, setting <xref:System.Windows.Forms.HtmlDocument.Domain%2A> to microsoft.com would allow both pages to communicate with one another.  
   
  Strings assigned to the <xref:System.Windows.Forms.HtmlDocument.Domain%2A> property must be valid top-level domains. In the previous URL example, you can set <xref:System.Windows.Forms.HtmlDocument.Domain%2A> to microsoft.com, but not to .com, which would enable any page on the Internet to script a page's contents.  
   
@@ -1884,4 +1884,4 @@ window.alert("Name is " + name + "; address is " + address);
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>