Un-encode characters in xref links (Xml/Xaml/ServiceModel/Workflow) (#12467)

Author: gewarren

xml/System.ServiceModel.Activation/ServiceHostFactory.xml

@@ -29,23 +29,23 @@
   <Docs>
     <summary>Factory that provides instances of <see cref="T:System.ServiceModel.ServiceHost" /> in managed hosting environments where the host instance is created dynamically in response to incoming messages.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The managed hosting environments that support dynamic activation are Internet Information Services (IIS) and Windows Process Activation Service (WAS).  
-  
- If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHost>, consider also implementing a factory that derives from the <xref:System.ServiceModel.Activation.ServiceHostFactory> class.  
-  
- If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHostBase> instead, then consider also implementing a factory that derives your factory from <xref:System.ServiceModel.Activation.ServiceHostFactoryBase> directly.  
-  
-   
-  
-## Examples  
- This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory> class:  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The managed hosting environments that support dynamic activation are Internet Information Services (IIS) and Windows Process Activation Service (WAS).
+
+ If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHost>, consider also implementing a factory that derives from the <xref:System.ServiceModel.Activation.ServiceHostFactory> class.
+
+ If you have implemented a custom derivative of <xref:System.ServiceModel.ServiceHostBase> instead, then consider also implementing a factory that derives your factory from <xref:System.ServiceModel.Activation.ServiceHostFactoryBase> directly.
+
+
+
+## Examples
+ This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory> class:
+
  :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet0":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet0":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet0":::
+
  ]]></format>
     </remarks>
   </Docs>
@@ -69,14 +69,14 @@
       <Docs>
         <summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activation.ServiceHostFactory" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.%23ctor%2A>:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Examples
+ This examples show how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.%23ctor*>:
+
  :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet1":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet1":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -119,14 +119,14 @@
         <summary>Creates a <see cref="T:System.ServiceModel.ServiceHost" /> with specific base addresses and initializes it with specified data.</summary>
         <returns>A <see cref="T:System.ServiceModel.ServiceHost" /> with specific base addresses.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- This example shows how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost%28System.String%2CSystem.Uri%5B%5D%29> method:  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Examples
+ This example shows how to use the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost(System.String,System.Uri[])> method:
+
  :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/servicehostfactory/cs/program.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/servicehostfactory/vb/program.vb" id="Snippet3":::
+
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentNullException">
@@ -163,13 +163,13 @@
         <summary>Creates a <see cref="T:System.ServiceModel.ServiceHost" /> for a specified type of service with a specific base address.</summary>
         <returns>A <see cref="T:System.ServiceModel.ServiceHost" /> for the type of service specified with a specific base address.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- This example shows how to create an override implementation of the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost%28System.Type%2CSystem.Uri%5B%5D%29> method:  
-  
-  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Examples
+ This example shows how to create an override implementation of the <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost(System.Type,System.Uri[])> method:
+
+
+
  ]]></format>
         </remarks>
       </Docs>

xml/System.ServiceModel.Activities.Configuration/SendMessageChannelCacheElement.xml

@@ -67,11 +67,11 @@
         <value>
           <see langword="true" /> if the workflow instance cache is turned on; otherwise, <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- In the majority of the cases when there are no custom bindings and/or behaviors, we turn on cache by default. In the case where the user did plug in their own binding and behaviors, the caching of the channel factories could become unsecure, therefore, we turn off our cache by default. But the user can set the <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement.AllowUnsafeCaching> back on which requires them to carefully read the appropriate MSDN document and make a decision that strikes a balance between security and performance.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ In the majority of the cases when there are no custom bindings and/or behaviors, we turn on cache by default. In the case where the user did plug in their own binding and behaviors, the caching of the channel factories could become unsecure, therefore, we turn off our cache by default. But the user can set the <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement.AllowUnsafeCaching> back on which requires them to carefully read the appropriate MSDN document and make a decision that strikes a balance between security and performance.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -171,11 +171,11 @@
         <summary>Gets or sets the settings of the channel factory cache.</summary>
         <value>The settings of the channel factory cache.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.
+
  ]]></format>
         </remarks>
       </Docs>

xml/System.ServiceModel.Activities/ReceiveContent.xml

@@ -16,13 +16,13 @@
   <Docs>
     <summary>An abstract base class for classes that represent the data received by a workflow service.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent> class to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.  
-  
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Examples
+ The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent> class to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::
+
  ]]></format>
     </remarks>
   </Docs>
@@ -59,13 +59,13 @@
         <summary>Creates a new <see cref="T:System.ServiceModel.Activities.ReceiveMessageContent" /> instance with the specified message.</summary>
         <returns>A <see cref="T:System.ServiceModel.Activities.ReceiveMessageContent" /> instance.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Examples  
- The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent.Create%2A> method to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.  
-  
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Examples
+ The following example shows how to use the <xref:System.ServiceModel.Activities.ReceiveContent.Create*> method to specify the content for a <xref:System.ServiceModel.Activities.Receive> activity.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/contentbasedcorrelation/cs/client.cs" id="Snippet3":::
+
  ]]></format>
         </remarks>
       </Docs>

xml/System.ServiceModel.Activities/SendMessageChannelCache.xml

@@ -20,22 +20,22 @@
   <Docs>
     <summary>Represents an extension that enables the customization of the cache sharing levels, the settings of the channel factory cache, and the settings of the channel cache for workflows that send messages to service endpoints using <see cref="T:System.ServiceModel.Activities.Send" /> messaging activities.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- This class is intended for workflows that send messages to service endpoints. These workflows are typically client workflows but could also be workflow services that are hosted in a <xref:System.ServiceModel.WorkflowServiceHost>.  
-  
- By default, in a workflow hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache used by <xref:System.ServiceModel.Activities.Send> messaging activities is shared across all workflow instances in the <xref:System.ServiceModel.WorkflowServiceHost> (host-level caching). For a client workflow that is not hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache is available only to the workflow instance (instance-level caching). Caching is disabled by default for any send activity in your workflow that has endpoints defined in configuration.  
-  
- For more information about how to change the default cache sharing levels and cache settings for the channel factory and channel cache, see [Changing the Cache Sharing Levels for Send Activities](/dotnet/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities).  
-  
-   
-  
-## Examples  
- The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.  
-  
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This class is intended for workflows that send messages to service endpoints. These workflows are typically client workflows but could also be workflow services that are hosted in a <xref:System.ServiceModel.WorkflowServiceHost>.
+
+ By default, in a workflow hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache used by <xref:System.ServiceModel.Activities.Send> messaging activities is shared across all workflow instances in the <xref:System.ServiceModel.WorkflowServiceHost> (host-level caching). For a client workflow that is not hosted by a <xref:System.ServiceModel.WorkflowServiceHost>, the cache is available only to the workflow instance (instance-level caching). Caching is disabled by default for any send activity in your workflow that has endpoints defined in configuration.
+
+ For more information about how to change the default cache sharing levels and cache settings for the channel factory and channel cache, see [Changing the Cache Sharing Levels for Send Activities](/dotnet/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities).
+
+
+
+## Examples
+ The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::
+
  ]]></format>
     </remarks>
   </Docs>
@@ -99,20 +99,20 @@
         <param name="channelSettings">The cache settings for cached channels.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activities.SendMessageChannelCache" /> class with custom factory cache and channel cache settings.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.  
-  
- You can choose to use only the channel factory cache and disable the channel cache by passing the `channelSettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. To disable the cache completely for both the channel factory cache and the channel cache, pass the `factorySettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. Note that you cannot turn the channel cache on if the channel factory cache is disabled.  
-  
-   
-  
-## Examples  
- The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.  
-  
- :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.
+
+ You can choose to use only the channel factory cache and disable the channel cache by passing the `channelSettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. To disable the cache completely for both the channel factory cache and the channel cache, pass the `factorySettings` parameter to this constructor initialized to a <xref:System.ServiceModel.Activities.ChannelCacheSettings> instance with a <xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache> value of 0. Note that you cannot turn the channel cache on if the channel factory cache is disabled.
+
+
+
+## Examples
+ The following example shows how to use the <xref:System.ServiceModel.Activities.SendMessageChannelCache> class to share a channel cache between two workflow applications in a single app domain.
+
+ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/channelcache/cs/client.cs" id="Snippet0":::
+
  ]]></format>
         </remarks>
       </Docs>
@@ -141,13 +141,13 @@
           <see langword="true" /> to turn caching on; otherwise, <see langword="false" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ServiceModel.Activities.SendMessageChannelCache" /> class with custom factory cache settings, custom channel cache settings, and a value that indicates whether to turn caching on.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- By default, the cache is only available for <xref:System.ServiceModel.Activities.Send> activities that don't use endpoints defined in configuration. However, if you want to turn caching on in this case call this constructor with the `allowUnsafeCaching` parameter set to `true`. Next, add the new instance of this class as an extension to a workflow service host or a workflow instance.  
-  
- For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ By default, the cache is only available for <xref:System.ServiceModel.Activities.Send> activities that don't use endpoints defined in configuration. However, if you want to turn caching on in this case call this constructor with the `allowUnsafeCaching` parameter set to `true`. Next, add the new instance of this class as an extension to a workflow service host or a workflow instance.
+
+ For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -178,11 +178,11 @@
         <value>
           <see langword="true" /> to turn caching on; otherwise, <see langword="false" />.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- If the <xref:System.ServiceModel.Activities.Send> activity in your workflow has endpoints defined in configuration caching could be unsecure and therefore is disabled by default. However, if you want to turn caching on set this property to `true`.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ If the <xref:System.ServiceModel.Activities.Send> activity in your workflow has endpoints defined in configuration caching could be unsecure and therefore is disabled by default. However, if you want to turn caching on set this property to `true`.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -263,11 +263,11 @@
         <summary>Gets or sets the settings of the channel factory cache.</summary>
         <value>The settings of the channel factory cache.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory%601>.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The channel factory cache represents cached channel factories. For more information about channel factories, see <xref:System.ServiceModel.ChannelFactory> and <xref:System.ServiceModel.ChannelFactory`1>.
+
  ]]></format>
         </remarks>
       </Docs>