remove URI tokens (#3362)

* remove URI tokens

* Update xml/System.Windows.Documents/Hyperlink.xml

Co-Authored-By: Andy De George <[email protected]>

Author: mairaw

includes/tla2sharptla-uri-md.md

@@ -81,7 +81,7 @@
   
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentException">Either <paramref name="firstPackUri" /> or <paramref name="secondPackUri" /> is not an absolute [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)].  
+        <exception cref="T:System.ArgumentException">Either <paramref name="firstPackUri" /> or <paramref name="secondPackUri" /> is not an absolute URI.  
 
  -or-  
 
@@ -117,9 +117,9 @@
         <Parameter Name="secondPartUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <param name="firstPartUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the first <see cref="T:System.IO.Packaging.PackagePart" />.</param>
-        <param name="secondPartUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the second <see cref="T:System.IO.Packaging.PackagePart" />.</param>
-        <summary>Returns a value that indicates whether two package part [!INCLUDE[TLA2#tla_uri#plural](~/includes/tla2sharptla-urisharpplural-md.md)] are equivalent.</summary>
+        <param name="firstPartUri">The URI of the first <see cref="T:System.IO.Packaging.PackagePart" />.</param>
+        <param name="secondPartUri">The URI of the second <see cref="T:System.IO.Packaging.PackagePart" />.</param>
+        <summary>Returns a value that indicates whether two package part URIs are equivalent.</summary>
         <returns>A value that indicates the relationship between <paramref name="firstPartUri" /> and <paramref name="secondPartUri" />.  
 
  <list type="table"><listheader><term> Value  
@@ -143,12 +143,12 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- If both `firstPartUri` and `secondPartUri` are `null`, <xref:System.IO.Packaging.PackUriHelper.ComparePartUri%2A> returns 0. When comparing <xref:System.IO.Packaging.PackagePart> [!INCLUDE[TLA2#tla_uri#plural](~/includes/tla2sharptla-urisharpplural-md.md)], a null [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] is always less than a non-null [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)]. For cases where `firstPartUri` and `secondPartUri` are both relative <xref:System.IO.Packaging.PackagePart> URIs, <xref:System.IO.Packaging.PackUriHelper.ComparePartUri%2A> performs the comparison.  
+ If both `firstPartUri` and `secondPartUri` are `null`, <xref:System.IO.Packaging.PackUriHelper.ComparePartUri%2A> returns 0. When comparing <xref:System.IO.Packaging.PackagePart> URIs, a null URI is always less than a non-null URI. For cases where `firstPartUri` and `secondPartUri` are both relative <xref:System.IO.Packaging.PackagePart> URIs, <xref:System.IO.Packaging.PackUriHelper.ComparePartUri%2A> performs the comparison.  
   
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
-          <paramref name="firstPartUri" /> or <paramref name="secondPartUri" /> is not a valid part [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] syntax.</exception>
+          <paramref name="firstPartUri" /> or <paramref name="secondPartUri" /> is not a valid part URI syntax.</exception>
         <altmember cref="M:System.IO.Packaging.PackUriHelper.ComparePackUri(System.Uri,System.Uri)" />
       </Docs>
     </Member>
@@ -284,9 +284,9 @@
         <Parameter Name="partUri" Type="System.Uri" Index="1" FrameworkAlternate="netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;dotnet-plat-ext-3.0;netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="packageUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the <see cref="T:System.IO.Packaging.Package" />.</param>
-        <param name="partUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the <see cref="T:System.IO.Packaging.PackagePart" /> in the package.</param>
-        <summary>Creates a pack URI given a <see cref="T:System.IO.Packaging.Package" /> [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] and the [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of a part in the package.</summary>
+        <param name="packageUri">The URI of the <see cref="T:System.IO.Packaging.Package" />.</param>
+        <param name="partUri">The URI of the <see cref="T:System.IO.Packaging.PackagePart" /> in the package.</param>
+        <summary>Creates a pack URI given a <see cref="T:System.IO.Packaging.Package" /> URI and the URI of a part in the package.</summary>
         <returns>The pack URI of the given <see cref="T:System.IO.Packaging.PackagePart" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -359,10 +359,10 @@
         <Parameter Name="fragment" Type="System.String" Index="2" FrameworkAlternate="netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;dotnet-plat-ext-3.0;netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="packageUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the <see cref="T:System.IO.Packaging.Package" />.</param>
-        <param name="partUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the <see cref="T:System.IO.Packaging.PackagePart" /> in the package.</param>
+        <param name="packageUri">The URI of the <see cref="T:System.IO.Packaging.Package" />.</param>
+        <param name="partUri">The URI of the <see cref="T:System.IO.Packaging.PackagePart" /> in the package.</param>
         <param name="fragment">A "#" reference identifying an element within the package part.</param>
-        <summary>Creates a pack URI given a <see cref="T:System.IO.Packaging.Package" /> [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)], the [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of a part in the package, and a "#" fragment to append.</summary>
+        <summary>Creates a pack URI given a <see cref="T:System.IO.Packaging.Package" /> URI, the URI of a part in the package, and a "#" fragment to append.</summary>
         <returns>The pack URI that identifies the specified package, package part, and fragment.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -452,7 +452,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of a <xref:System.IO.Packaging.PackagePart> is always referenced from the <xref:System.IO.Packaging.Package> root.  
+ The URI of a <xref:System.IO.Packaging.PackagePart> is always referenced from the <xref:System.IO.Packaging.Package> root.  
   
  The returned <xref:System.IO.Packaging.PackagePart> URI is an absolute path that always starts with "/" and conforms to the syntax defined in the [Open Packaging Conventions Specification](https://go.microsoft.com/fwlink/?LinkID=71255).  
   
@@ -676,7 +676,7 @@ The partUri extracted from <paramref name="packUri" /> does not conform to the v
       </Parameters>
       <Docs>
         <param name="partUri">The <see cref="P:System.IO.Packaging.PackagePart.Uri" /> of the <see cref="T:System.IO.Packaging.PackagePart" /> to return the URI for the associated <see cref="T:System.IO.Packaging.PackageRelationship" />.</param>
-        <summary>Returns the [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the relationship part associated with a specified <see cref="T:System.IO.Packaging.PackagePart" />.</summary>
+        <summary>Returns the URI of the relationship part associated with a specified <see cref="T:System.IO.Packaging.PackagePart" />.</summary>
         <returns>The URI of the <see cref="T:System.IO.Packaging.PackageRelationship" /> part associated with the <see cref="T:System.IO.Packaging.PackagePart" /> identified by <paramref name="partUri" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -737,10 +737,10 @@ The partUri extracted from <paramref name="packUri" /> does not conform to the v
         <Parameter Name="targetPartUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <param name="sourcePartUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the source part.</param>
-        <param name="targetPartUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the target part.</param>
-        <summary>Returns the relative [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] between two specified <see cref="T:System.IO.Packaging.PackagePart" /> [!INCLUDE[TLA2#tla_uri#plural](~/includes/tla2sharptla-urisharpplural-md.md)].</summary>
-        <returns>The relative [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] from <paramref name="sourcePartUri" /> to <paramref name="targetPartUri" />.</returns>
+        <param name="sourcePartUri">The URI of the source part.</param>
+        <param name="targetPartUri">The URI of the target part.</param>
+        <summary>Returns the relative URI between two specified <see cref="T:System.IO.Packaging.PackagePart" /> URIs.</summary>
+        <returns>The relative URI from <paramref name="sourcePartUri" /> to <paramref name="targetPartUri" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -789,8 +789,8 @@ The partUri extracted from <paramref name="packUri" /> does not conform to the v
         <Parameter Name="relationshipPartUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <param name="relationshipPartUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the relationship part to return the <see cref="P:System.IO.Packaging.PackageRelationship.SourceUri" /> from.</param>
-        <summary>Returns the <see cref="P:System.IO.Packaging.PackageRelationship.SourceUri" /> from the <see cref="T:System.IO.Packaging.PackageRelationship" /> with a specified [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)].</summary>
+        <param name="relationshipPartUri">The URI of the relationship part to return the <see cref="P:System.IO.Packaging.PackageRelationship.SourceUri" /> from.</param>
+        <summary>Returns the <see cref="P:System.IO.Packaging.PackageRelationship.SourceUri" /> from the <see cref="T:System.IO.Packaging.PackageRelationship" /> with a specified URI.</summary>
         <returns>The <see cref="P:System.IO.Packaging.PackageRelationship.SourceUri" /> of the <see cref="T:System.IO.Packaging.PackagePart" /> from the relationship with the specified <paramref name="relationshipPartUri" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
@@ -805,7 +805,7 @@ The partUri extracted from <paramref name="packUri" /> does not conform to the v
         <exception cref="T:System.ArgumentNullException">
           <paramref name="relationshipPartUri" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
-          <paramref name="relationshipPartUri" /> is an absolute [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)].  
+          <paramref name="relationshipPartUri" /> is an absolute URI.  
 
  -or-  
 
@@ -849,7 +849,7 @@ The partUri extracted from <paramref name="packUri" /> does not conform to the v
         <Parameter Name="partUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <param name="partUri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] to check for a <see cref="T:System.IO.Packaging.PackageRelationship" /> part.</param>
+        <param name="partUri">The URI to check for a <see cref="T:System.IO.Packaging.PackageRelationship" /> part.</param>
         <summary>Returns a value that indicates whether a specified URI is the URI of a <see cref="T:System.IO.Packaging.PackageRelationship" /> part.</summary>
         <returns>
           <see langword="true" /> if <paramref name="partUri" /> identifies a <see cref="T:System.IO.Packaging.PackageRelationship" /> part; otherwise, <see langword="false" />.</returns>
@@ -863,7 +863,7 @@ This method does not inspect the part contents; it is based solely on the name.
         <exception cref="T:System.ArgumentNullException">
           <paramref name="partUri" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
-          <paramref name="partUri" /> is an absolute [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)].  
+          <paramref name="partUri" /> is an absolute URI.  
 
  -or-  
 

includes/tla2sharptla-urisharpplural-md.md

@@ -120,7 +120,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Note that the pack URI protocol does not process information in the request other than the [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)].  For most traditional purposes (such as estimating the size of POST information), there is no need for this property.  
+ Note that the pack URI protocol does not process information in the request other than the uniform resource identifier (URI).  For most traditional purposes (such as estimating the size of POST information), there is no need for this property.  
   
  <xref:System.IO.Packaging.PackWebRequest.ContentLength%2A> returns 0 if the request resolves from the <xref:System.IO.Packaging.PackageStore> cache.  
   
@@ -154,7 +154,7 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Note that the pack URI protocol does not process information in the request other than the [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)].  For most purposes (such as determining the type of POST information), there is no use for this property.  
+ Note that the pack URI protocol does not process information in the request other than the uniform resource identifier (URI).  For most purposes (such as determining the type of POST information), there is no use for this property.  
   
  <xref:System.IO.Packaging.PackWebRequest.ContentType%2A> returns an empty string if the request resolves from the <xref:System.IO.Packaging.PackageStore> cache.  
   
@@ -449,8 +449,8 @@
         <ReturnType>System.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the resource associated with the request.</summary>
-        <value>The [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)] of the resource associated with the request.</value>
+        <summary>Gets the URI of the resource associated with the request.</summary>
+        <value>The uniform resource identifier (URI) of the resource associated with the request.</value>
         <remarks>To be added.</remarks>
         <altmember cref="T:System.IO.Packaging.PackUriHelper" />
       </Docs>

includes/tlasharptla-uri-md.md

@@ -76,14 +76,14 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <param name="uri">The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] to create the Web request.</param>
+        <param name="uri">The URI to create the Web request.</param>
         <summary>This member supports the [!INCLUDE[TLA#tla_winclient](~/includes/tlasharptla-winclient-md.md)] infrastructure and is not intended to be used directly from your code.  Use the type-safe <see cref="T:System.IO.Packaging.PackUriHelper" /> method instead.</summary>
         <returns>The pack URI Web request.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- Creates a pack URI Web request from a given [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)].  
+ Creates a pack URI Web request from a given uniform resource identifier (URI).  
   
  ]]></format>
         </remarks>

includes/tlasharptla-urisharpinitcapsharpplural-md.md

@@ -22,7 +22,7 @@
 ## Remarks  
  When you use the pack URI protocol, you can reference a package and its part elements either locally from inside a package or externally from a Web source.  
   
- For the pack URI protocol, the forward-slash characters (//) of an embedded [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)] are represented by commas (,,). For example: `pack://http:,,www.adatum.com,folder,file.package/images/picture1.jpg` references the file `/images/picture1.jpg` that is contained in `http://www.adatum.com/folder/file.package`.  
+ For the pack URI protocol, the forward-slash characters (//) of an embedded uniform resource identifier (URI) are represented by commas (,,). For example: `pack://http:,,www.adatum.com,folder,file.package/images/picture1.jpg` references the file `/images/picture1.jpg` that is contained in `http://www.adatum.com/folder/file.package`.  
   
  ]]></format>
     </remarks>
@@ -278,8 +278,8 @@
         <ReturnType>System.Uri</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the [!INCLUDE[TLA#tla_uri](~/includes/tlasharptla-uri-md.md)] of the response.</summary>
-        <value>The [!INCLUDE[TLA2#tla_uri](~/includes/tla2sharptla-uri-md.md)] of the response.</value>
+        <summary>Gets the uniform resource identifier (URI) of the response.</summary>
+        <value>The URI of the response.</value>
         <remarks>To be added.</remarks>
         <related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=73431">The Addressing Model of the Open Packaging Conventions</related>
       </Docs>