markdig fixes - Part 6 (#2563)

mairaw · Ron Petrusha · web-flow · commit ac67e69a249a · 2019-06-06T20:58:25.000-07:00
* markdig fixes - bare urls

* Apply suggestions from peer review

Co-Authored-By: Ron Petrusha &lt;ronpet@microsoft.com&gt;
diff --git a/xml/System.Net.Sockets/UdpClient.xml b/xml/System.Net.Sockets/UdpClient.xml
@@ -53,7 +53,7 @@
    
   
 ## Examples  
- The following example establishes a <xref:System.Net.Sockets.UdpClient> connection using the host name www.contoso.com on port 11000. A small string message is sent to two separate remote host machines. The <xref:System.Net.Sockets.UdpClient.Receive%2A> method blocks execution until a message is received. Using the <xref:System.Net.IPEndPoint> passed to <xref:System.Net.Sockets.UdpClient.Receive%2A>, the identity of the responding host is revealed.  
+ The following example establishes a <xref:System.Net.Sockets.UdpClient> connection using the host name `www.contoso.com` on port 11000. A small string message is sent to two separate remote host machines. The <xref:System.Net.Sockets.UdpClient.Receive%2A> method blocks execution until a message is received. Using the <xref:System.Net.IPEndPoint> passed to <xref:System.Net.Sockets.UdpClient.Receive%2A>, the identity of the responding host is revealed.  
   
  [!code-cpp[Classic UdpClientExample#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic UdpClientExample/CPP/source.cpp#1)]
  [!code-csharp[Classic UdpClientExample#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic UdpClientExample/CS/source.cs#1)]
diff --git a/xml/System.Net/Dns.xml b/xml/System.Net/Dns.xml
@@ -40,7 +40,7 @@
    
   
 ## Examples  
- The following example queries the DNS database for information on the host www.contoso.com.  
+ The following example queries the DNS database for information on the host `www.contoso.com`.  
   
  [!code-cpp[Classic Dns Example#1](~/samples/snippets/cpp/VS_Snippets_Remoting/Classic Dns Example/CPP/source.cpp#1)]
  [!code-csharp[Classic Dns Example#1](~/samples/snippets/csharp/VS_Snippets_Remoting/Classic Dns Example/CS/source.cs#1)]
diff --git a/xml/System.Runtime.Remoting.Metadata/SoapMethodAttribute.xml b/xml/System.Runtime.Remoting.Metadata/SoapMethodAttribute.xml
@@ -208,7 +208,7 @@
 ## Remarks  
  This property is currently not implemented.  
   
- The SOAPAction HTTP request header field indicates the intent of the SOAP HTTP request. For more information on the SOAPAction field, see www.w3.org/tr/soap/#_Toc478383528.  
+ The SOAPAction HTTP request header field indicates the intent of the SOAP HTTP request. For more information on the SOAPAction field, see [The SOAPAction HTTP Header Field](https://www.w3.org/TR/2000/NOTE-SOAP-20000508/#_Toc478383528) section of the W3C specification.  
   
    
   
diff --git a/xml/System.Security.Cryptography.Xml/Signature.xml b/xml/System.Security.Cryptography.Xml/Signature.xml
@@ -29,7 +29,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.Signature> class represents the <`Signature`> element of an XML signature defined by the XML digital signature specification. The <`Signature`> element is the root element of an XML digital signature. The <xref:System.Security.Cryptography.Xml.Signature.SignedInfo%2A>, <xref:System.Security.Cryptography.Xml.Signature.SignatureValue%2A>, <xref:System.Security.Cryptography.Xml.Signature.KeyInfo%2A>, and <xref:System.Security.Cryptography.Xml.Signature.ObjectList%2A> properties encapsulate the subelements of the <`Signature`> element.  
   
- For more information about the <`Signature`> element, see the W3C specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about the <`Signature`> element, see the [W3C specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -238,7 +238,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.Signature.KeyInfo%2A> property uses a <xref:System.Security.Cryptography.Xml.KeyInfo> object to represent the <`KeyInfo`> element of an XML digital signature.  
   
- For more information about XML digital signatures, see the W3C specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [W3C specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -333,7 +333,7 @@
   
  You can also add a <xref:System.Security.Cryptography.Xml.DataObject> to this collection using the <xref:System.Security.Cryptography.Xml.Signature.AddObject%2A> method.  
   
- For more information about XML digital signatures, see the W3C specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [W3C specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -372,7 +372,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.Signature.SignatureValue%2A> property uses a byte array to represent the <`SignatureValue`> element of an XML digital signature contained within.  
   
- For more information about XML digital signatures, see the W3C specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [W3C specification](https://www.w3.org/TR/xmldsig-core/).  
   
  ]]></format>
         </remarks>
@@ -411,7 +411,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.Signature.SignedInfo%2A> property uses the <xref:System.Security.Cryptography.Xml.SignedInfo> class to represent the <`SignedInfo`> element of an XML digital signature contained within.  
   
- For more information about XML digital signatures, see the W3C specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about XML digital signatures, see the [W3C specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
diff --git a/xml/System.Security.Cryptography.Xml/TransformChain.xml b/xml/System.Security.Cryptography.Xml/TransformChain.xml
@@ -35,7 +35,7 @@
   
  If you want to sign only a portion of an XML document, you can use a transform to identify the XML elements you intend to sign.  Note that the <xref:System.Security.Cryptography.Xml.Reference.Uri%2A> property and the <xref:System.Security.Cryptography.Xml.EncryptedReference.Uri%2A> property automatically create internal transforms that allow you to sign a portion of a document.  
   
- For more information about transforms, 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 transforms, 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 from the W3C website.  
   
  ]]></format>
     </remarks>
diff --git a/xml/System.Security.Cryptography.Xml/X509IssuerSerial.xml b/xml/System.Security.Cryptography.Xml/X509IssuerSerial.xml
@@ -36,7 +36,7 @@
   
  Use the <xref:System.Security.Cryptography.Xml.X509IssuerSerial> structure to specify a certificate issuer's distinguished name and serial number pair when using the <xref:System.Security.Cryptography.Xml.KeyInfoX509Data> class.  You can add an <xref:System.Security.Cryptography.Xml.X509IssuerSerial> structure to the <xref:System.Security.Cryptography.Xml.KeyInfoX509Data> class using the <xref:System.Security.Cryptography.Xml.KeyInfoX509Data.IssuerSerials%2A> property.  Alternatively, you can add string values that represent the X.509 certificate issuer's distinguished name and serial number pair using the <xref:System.Security.Cryptography.Xml.KeyInfoX509Data.AddIssuerSerial%2A> method.  
   
- For more information about the `<X509IssuerSerial`> element, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<X509IssuerSerial`> element, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -85,7 +85,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.X509IssuerSerial.IssuerName%2A> property represents an X.509 certificate issuer's distinguished name specified in the `<X509IssuerSerial`> element.  
   
- For more information about the `<X509IssuerSerial`> element, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<X509IssuerSerial`> element, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
@@ -134,7 +134,7 @@
 ## Remarks  
  The <xref:System.Security.Cryptography.Xml.X509IssuerSerial.SerialNumber%2A> property represents an X.509 certificate issuer's serial number specified in the `<X509IssuerSerial`> element.  
   
- For more information about the `<X509IssuerSerial`> element, see the World Wide Web Consortium (W3C) specification at www.w3.org/TR/xmldsig-core/.  
+ For more information about the `<X509IssuerSerial`> element, see the [World Wide Web Consortium (W3C) specification](https://www.w3.org/TR/xmldsig-core/).  
   
    
   
diff --git a/xml/System.Security.Cryptography.Xml/XmlDsigExcC14NWithCommentsTransform.xml b/xml/System.Security.Cryptography.Xml/XmlDsigExcC14NWithCommentsTransform.xml
@@ -34,7 +34,7 @@
   
  The URI that describes the <xref:System.Security.Cryptography.Xml.XmlDsigExcC14NWithCommentsTransform> class is defined by the <xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigExcC14NWithCommentsTransformUrl> field.  
   
- For more information about the exclusive C14N transform, see the XMLDSIG specification, which is available from the World Wide Web Consortium (W3C) at www.w3.org/TR/xmldsig-core/. The canonicalization algorithm is defined in the W3C Canonical XML specification, which is available at www.w3.org/2001/10/xml-exc-c14n.  
+ For more information about the exclusive C14N transform, see the [XMLDSIG specification](https://www.w3.org/TR/xmldsig-core/), which is available from the W3C website. The canonicalization algorithm is defined in the [W3C Canonical XML specification](https://www.w3.org/TR/2002/REC-xml-exc-c14n-20020718/).  
   
    
   
@@ -118,4 +118,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>
diff --git a/xml/System.Xml.Serialization/XmlAnyElementAttribute.xml b/xml/System.Xml.Serialization/XmlAnyElementAttribute.xml
@@ -346,7 +346,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property allows you to set a unique name for the XML attribute. The <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property conforms to the rules for creating an XML namespace as found in the World Wide Web Consortium (www.w3.org) document, "Namespaces in XML."  
+ The <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property allows you to set a unique name for the XML attribute. The <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property conforms to the rules for creating an XML namespace as found in the [Namespaces in XML](https://www.w3.org/TR/xml-names/) document from the World Wide Web Consortium.
   
  To set the <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property to a prefixed name, create an <xref:System.Xml.Serialization.XmlSerializerNamespaces> that contains the namespaces and prefixes used in the XML document. Set the <xref:System.Xml.Serialization.XmlAnyElementAttribute.Namespace%2A> property to one of the namespaces in the <xref:System.Xml.Serialization.XmlSerializerNamespaces>. When the XML is generated, the attribute name is correctly prefixed with the prefix associated with the specified namespace.  
   
diff --git a/xml/System.Xml.Serialization/XmlAttributeAttribute.xml b/xml/System.Xml.Serialization/XmlAttributeAttribute.xml
@@ -403,7 +403,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the XSD data type of the XML attribute generated by the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</summary>
-        <value>An XSD (XML Schema Document) data type, as defined by the World Wide Web Consortium (www.w3.org) document named "XML Schema: DataTypes".</value>
+        <value>An XSD (XML Schema Document) data type.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -420,7 +420,7 @@
 > [!NOTE]
 >  Passing binary data as an XML element is more efficient than passing it as an XML attribute.  
   
- For more information about XML data types, see the World Wide Web Consortium (www.w3.org) document named "XML Schema Part 2: Datatypes".  
+ For more information about XML data types, see the [XML Schema Part 2: DataTypes](https://www.w3.org/TR/xmlschema-2/) document from the World Wide Web Consortium.  
   
 |XSD data type|.NET data type|  
 |-------------------|--------------------|  
diff --git a/xml/ns-System.Runtime.Remoting.Metadata.xml b/xml/ns-System.Runtime.Remoting.Metadata.xml
@@ -1,6 +1,15 @@
 <Namespace Name="System.Runtime.Remoting.Metadata">
   <Docs>
-    <summary>The <see cref="N:System.Runtime.Remoting.Metadata" /> namespace contains classes and attributes that can be used to customize generation and processing of SOAP for objects and fields. The classes of this namespace can be used to indicate the SOAPAction header field, type output, XML element name, and the method XML namespace URI. This information is used by the SOAP serializer during SOAP generation and the <see href="https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/xd176a6c(v=vs.100)">Soapsuds Tool (Soapsuds.exe)</see> during Web Services Description Language (WSDL) generation. The information specified by the attributes in this namespace can be used on the receiving end of the generated SOAP to customize processing of the remoted method calls and objects. One of the most important classes of the <see cref="N:System.Runtime.Remoting.Metadata" /> namespace is <see cref="T:System.Runtime.Remoting.Metadata.SoapAttribute" /> class. The <see cref="T:System.Runtime.Remoting.Metadata.SoapAttribute" /> class is nonfunctional, and can only be used as the base class for all the metadata attributes. For more information on the SOAPAction HTTP header field, see www.w3.org/tr/soap/#_Toc478383528.</summary>
-    <remarks>To be added.</remarks>
+    <summary>The <see cref="N:System.Runtime.Remoting.Metadata" /> namespace contains classes and attributes that can be used to customize generation and processing of SOAP for objects and fields. The classes of this namespace can be used to indicate the SOAPAction header field, type output, XML element name, and the method XML namespace URI. This information is used by the SOAP serializer during SOAP generation and the <see href="https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/xd176a6c(v=vs.100)">Soapsuds Tool (Soapsuds.exe)</see> during Web Services Description Language (WSDL) generation. The information specified by the attributes in this namespace can be used on the receiving end of the generated SOAP to customize processing of the remoted method calls and objects. One of the most important classes of the <see cref="N:System.Runtime.Remoting.Metadata" /> namespace is <see cref="T:System.Runtime.Remoting.Metadata.SoapAttribute" /> class. The <see cref="T:System.Runtime.Remoting.Metadata.SoapAttribute" /> class is nonfunctional, and can only be used as the base class for all the metadata attributes.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+  
+For more information on the SOAPAction HTTP header field, see [The SOAPAction HTTP Header Field](https://www.w3.org/TR/2000/NOTE-SOAP-20000508/#_Toc478383528) section of the W3C specification.  
+  
+ ]]></format>
+        </remarks>
+
   </Docs>
 </Namespace>
