From 13cd91316c5790edc737c006aa41323f54f5ddbe Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 2 Apr 2026 13:10:22 -0700 Subject: [PATCH 1/3] Don't un-encode # --- xml/System.ServiceModel.Channels/ChannelBase.xml | 8 ++++---- .../ChannelManagerBase.xml | 4 ++-- xml/System.ServiceModel.Channels/IOutputChannel.xml | 2 +- xml/System.ServiceModel.Channels/IRequestChannel.xml | 2 +- .../MessageEncodingBindingElementImporter.xml | 2 +- .../MtomMessageEncodingBindingElement.xml | 2 +- .../StandardBindingImporter.xml | 2 +- .../TextMessageEncodingBindingElement.xml | 4 ++-- .../TransactionFlowBindingElementImporter.xml | 2 +- .../WebMessageEncodingBindingElement.xml | 2 +- .../ClientCredentials.xml | 2 +- .../DiscoveryServiceExtension.xml | 2 +- .../MessageFilterTable`1.xml | 4 ++-- xml/System.ServiceModel/MsmqBindingBase.xml | 2 +- xml/System.ServiceModel/WSDualHttpBinding.xml | 2 +- xml/System.Workflow.Activities/ActiveDirectoryRole.xml | 2 +- .../ActivityDesigner.xml | 4 ++-- .../TypeBrowserDialog.xml | 10 +++++----- .../WorkflowTheme.xml | 2 +- .../WorkflowMarkupSerializationManager.xml | 6 +++--- .../ActivityCollection.xml | 2 +- .../SqlWorkflowPersistenceService.xml | 4 ++-- .../WorkflowWebHostingModule.xml | 4 ++-- 23 files changed, 38 insertions(+), 38 deletions(-) diff --git a/xml/System.ServiceModel.Channels/ChannelBase.xml b/xml/System.ServiceModel.Channels/ChannelBase.xml index 6ba4a89192b..7925419d425 100644 --- a/xml/System.ServiceModel.Channels/ChannelBase.xml +++ b/xml/System.ServiceModel.Channels/ChannelBase.xml @@ -474,7 +474,7 @@ calls . + calls . ]]> @@ -518,7 +518,7 @@ calls . + calls . ]]> @@ -568,7 +568,7 @@ calls . + calls . ]]> @@ -618,7 +618,7 @@ calls . + calls . ]]> diff --git a/xml/System.ServiceModel.Channels/ChannelManagerBase.xml b/xml/System.ServiceModel.Channels/ChannelManagerBase.xml index 22472774cb8..71f15a41e28 100644 --- a/xml/System.ServiceModel.Channels/ChannelManagerBase.xml +++ b/xml/System.ServiceModel.Channels/ChannelManagerBase.xml @@ -313,7 +313,7 @@ calls . + calls . ]]> @@ -363,7 +363,7 @@ calls . + calls . ]]> diff --git a/xml/System.ServiceModel.Channels/IOutputChannel.xml b/xml/System.ServiceModel.Channels/IOutputChannel.xml index cb22c70a09a..4859503ac20 100644 --- a/xml/System.ServiceModel.Channels/IOutputChannel.xml +++ b/xml/System.ServiceModel.Channels/IOutputChannel.xml @@ -57,7 +57,7 @@ [!INCLUDE [untrusted-data-interface-note](~/includes/untrusted-data-interface-note.md)] - The interface defines synchronous and asynchronous variants of the operation. It provides a for the destination of the messages sent out on the channel. + The interface defines synchronous and asynchronous variants of the operation. It provides a for the destination of the messages sent out on the channel. ]]> diff --git a/xml/System.ServiceModel.Channels/IRequestChannel.xml b/xml/System.ServiceModel.Channels/IRequestChannel.xml index 0cf542fd9c4..7caa53c7f03 100644 --- a/xml/System.ServiceModel.Channels/IRequestChannel.xml +++ b/xml/System.ServiceModel.Channels/IRequestChannel.xml @@ -57,7 +57,7 @@ [!INCLUDE [untrusted-data-interface-note](~/includes/untrusted-data-interface-note.md)] - The defines synchronous and asynchronous variants of a method that returns a response message. It also provides a and properties to retrieve the endpoint address and URI to which the request message is sent. + The defines synchronous and asynchronous variants of a method that returns a response message. It also provides a and properties to retrieve the endpoint address and URI to which the request message is sent. ]]> diff --git a/xml/System.ServiceModel.Channels/MessageEncodingBindingElementImporter.xml b/xml/System.ServiceModel.Channels/MessageEncodingBindingElementImporter.xml index d530fddc88c..58d292cacbb 100644 --- a/xml/System.ServiceModel.Channels/MessageEncodingBindingElementImporter.xml +++ b/xml/System.ServiceModel.Channels/MessageEncodingBindingElementImporter.xml @@ -29,7 +29,7 @@ ## Remarks Override this class to extend the standard mapping between WSDL and a message encoding binding element. Then attach your custom object to a `WsdlImporter` either programmatically or by using an application configuration file. You can also attach your custom object to the internal `WsdlImporter` used by the [Service Trace Viewer Tool (SvcTraceViewer.exe)](/dotnet/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe) using an application configuration file. - Use the method to directly modify the metadata that is then imported into message encoding binding elements. + Use the method to directly modify the metadata that is then imported into message encoding binding elements. ]]> diff --git a/xml/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml b/xml/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml index 2a6186ee3fc..2dd8851e8ff 100644 --- a/xml/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml +++ b/xml/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml @@ -844,7 +844,7 @@ method puts the SOAP message version into the WSDL. + The method puts the SOAP message version into the WSDL. ]]> diff --git a/xml/System.ServiceModel.Channels/StandardBindingImporter.xml b/xml/System.ServiceModel.Channels/StandardBindingImporter.xml index c1a962415ca..4167edff42d 100644 --- a/xml/System.ServiceModel.Channels/StandardBindingImporter.xml +++ b/xml/System.ServiceModel.Channels/StandardBindingImporter.xml @@ -26,7 +26,7 @@ ## Remarks Override this class to extend the standard mapping between WSDL and a standard binding. Then attach your custom object to a either programmatically or by using an application configuration file. You can also attach your custom object to the internal used by the [ServiceModel Metadata Utility Tool (Svcutil.exe)](/dotnet/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe) using an application configuration file. - Use the method to directly modify the metadata that is then imported into standard binding objects. + Use the method to directly modify the metadata that is then imported into standard binding objects. ]]> diff --git a/xml/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml b/xml/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml index 23a423678d8..97425bbd688 100644 --- a/xml/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml +++ b/xml/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml @@ -756,7 +756,7 @@ is responsible for setting information about the message version in the WSDL. But this is done by the method, not by , which is implemented but empty. + The is responsible for setting information about the message version in the WSDL. But this is done by the method, not by , which is implemented but empty. ]]> @@ -796,7 +796,7 @@ is responsible for setting information about the message version in the WSDL. But this is done by the method. + The is responsible for setting information about the message version in the WSDL. But this is done by the method. ]]> diff --git a/xml/System.ServiceModel.Channels/TransactionFlowBindingElementImporter.xml b/xml/System.ServiceModel.Channels/TransactionFlowBindingElementImporter.xml index ef735296f19..f1d6392de81 100644 --- a/xml/System.ServiceModel.Channels/TransactionFlowBindingElementImporter.xml +++ b/xml/System.ServiceModel.Channels/TransactionFlowBindingElementImporter.xml @@ -26,7 +26,7 @@ ## Remarks The service endpoint must have enabled transaction flow and its methods must flow transactions. The converted policy assertions all adhere to the WS-PolicyAssertions standard. - This class is used mainly by the infrastructure when it builds a proxy for a service that is transaction-flow enabled. Calling the method adds a instance to the collection of binding elements. This also adds instances, as appropriate, on the `Operations` collection present in the conversion context's contract. + This class is used mainly by the infrastructure when it builds a proxy for a service that is transaction-flow enabled. Calling the method adds a instance to the collection of binding elements. This also adds instances, as appropriate, on the `Operations` collection present in the conversion context's contract. ]]> diff --git a/xml/System.ServiceModel.Channels/WebMessageEncodingBindingElement.xml b/xml/System.ServiceModel.Channels/WebMessageEncodingBindingElement.xml index 87e623af2de..eb2cb12a79d 100644 --- a/xml/System.ServiceModel.Channels/WebMessageEncodingBindingElement.xml +++ b/xml/System.ServiceModel.Channels/WebMessageEncodingBindingElement.xml @@ -596,7 +596,7 @@ is responsible for setting information about the message version in the WSDL. But this is done by the method. + The is responsible for setting information about the message version in the WSDL. But this is done by the method. ]]> diff --git a/xml/System.ServiceModel.Description/ClientCredentials.xml b/xml/System.ServiceModel.Description/ClientCredentials.xml index a05b2ba723b..f4d49b1938b 100644 --- a/xml/System.ServiceModel.Description/ClientCredentials.xml +++ b/xml/System.ServiceModel.Description/ClientCredentials.xml @@ -731,7 +731,7 @@ method. + An explicit implementation of the method. ]]> diff --git a/xml/System.ServiceModel.Discovery/DiscoveryServiceExtension.xml b/xml/System.ServiceModel.Discovery/DiscoveryServiceExtension.xml index 91165ba5362..66b2b5f0d71 100644 --- a/xml/System.ServiceModel.Discovery/DiscoveryServiceExtension.xml +++ b/xml/System.ServiceModel.Discovery/DiscoveryServiceExtension.xml @@ -23,7 +23,7 @@ and override the method to return your custom discovery service. Add your derived class to the extensions that host your discoverable service. When the is called the behavior iterates through the extensions in the service host and looks for a . If one is found its is called to get the custom discovery service. If an extension is not found the default discovery service implementation is used. + Derive a class from and override the method to return your custom discovery service. Add your derived class to the extensions that host your discoverable service. When the is called the behavior iterates through the extensions in the service host and looks for a . If one is found its is called to get the custom discovery service. If an extension is not found the default discovery service implementation is used. ]]> diff --git a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml index 836704d1724..51aa841ee57 100644 --- a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml +++ b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml @@ -1162,7 +1162,7 @@ myFilters(filter) ## Remarks If the filter key of the `item` is present but is associated with data that differs from the `FilterData`, the method fails to remove the filter and returns `false`. - This method implements . + This method implements . ]]> @@ -1201,7 +1201,7 @@ myFilters(filter) . + This method implements . ]]> diff --git a/xml/System.ServiceModel/MsmqBindingBase.xml b/xml/System.ServiceModel/MsmqBindingBase.xml index 9109f2dead1..35b2b005276 100644 --- a/xml/System.ServiceModel/MsmqBindingBase.xml +++ b/xml/System.ServiceModel/MsmqBindingBase.xml @@ -513,7 +513,7 @@ property is set to `true` when the is `true`. + The property is set to `true` when the is `true`. ]]> diff --git a/xml/System.ServiceModel/WSDualHttpBinding.xml b/xml/System.ServiceModel/WSDualHttpBinding.xml index ff347e80824..1122757adbb 100644 --- a/xml/System.ServiceModel/WSDualHttpBinding.xml +++ b/xml/System.ServiceModel/WSDualHttpBinding.xml @@ -845,7 +845,7 @@ ## Examples - The following examples show how to get the value. + The following examples show how to get the value. :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/s_dualhttp/cs/program.cs" id="Snippet23"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CFX/s_dualhttp/vb/module1.vb" id="Snippet23"::: diff --git a/xml/System.Workflow.Activities/ActiveDirectoryRole.xml b/xml/System.Workflow.Activities/ActiveDirectoryRole.xml index 075932ce5b7..b9bad30d312 100644 --- a/xml/System.Workflow.Activities/ActiveDirectoryRole.xml +++ b/xml/System.Workflow.Activities/ActiveDirectoryRole.xml @@ -446,7 +446,7 @@ This member is an explicit interface member implementation. It can be used only allows this object to be serialized. + The implementation of allows this object to be serialized. ]]> diff --git a/xml/System.Workflow.ComponentModel.Design/ActivityDesigner.xml b/xml/System.Workflow.ComponentModel.Design/ActivityDesigner.xml index a5ad7adedea..6cf872a2d6d 100644 --- a/xml/System.Workflow.ComponentModel.Design/ActivityDesigner.xml +++ b/xml/System.Workflow.ComponentModel.Design/ActivityDesigner.xml @@ -3211,7 +3211,7 @@ represents the activity that the activity designer designs on the workflow design surface. + represents the activity that the activity designer designs on the workflow design surface. ]]> @@ -3542,7 +3542,7 @@ This member is an explicit interface member implementation. It can be used only returns a single-member array that contains . + Unless overridden in a deriving class, returns a single-member array that contains . ]]> diff --git a/xml/System.Workflow.ComponentModel.Design/TypeBrowserDialog.xml b/xml/System.Workflow.ComponentModel.Design/TypeBrowserDialog.xml index f153d7b7ec7..555700605d1 100644 --- a/xml/System.Workflow.ComponentModel.Design/TypeBrowserDialog.xml +++ b/xml/System.Workflow.ComponentModel.Design/TypeBrowserDialog.xml @@ -309,7 +309,7 @@ ## Remarks If the property returns a valid value--anything other than a null reference (`Nothing` in Visual Basic)--the component is added to . - This property is required because implements . For , always returns a null reference (`Nothing` in Visual Basic). + This property is required because implements . For , always returns a null reference (`Nothing` in Visual Basic). ]]> @@ -341,9 +341,9 @@ returns a null reference (`Nothing` in Visual Basic), has not bound an to the . + If returns a null reference (`Nothing` in Visual Basic), has not bound an to the . - This method is required because implements . For , always returns a null reference (`Nothing` in Visual Basic). + This method is required because implements . For , always returns a null reference (`Nothing` in Visual Basic). ]]> @@ -376,7 +376,7 @@ implements . For , always returns `true`. + This property is required because implements . For , always returns `true`. ]]> @@ -444,7 +444,7 @@ , returns a service object. Otherwise, it returns a null reference (`Nothing` in Visual Basic). + If `serviceType` is of type , returns a service object. Otherwise, it returns a null reference (`Nothing` in Visual Basic). ]]> diff --git a/xml/System.Workflow.ComponentModel.Design/WorkflowTheme.xml b/xml/System.Workflow.ComponentModel.Design/WorkflowTheme.xml index 9125e2a0ba9..48adce3e69b 100644 --- a/xml/System.Workflow.ComponentModel.Design/WorkflowTheme.xml +++ b/xml/System.Workflow.ComponentModel.Design/WorkflowTheme.xml @@ -373,7 +373,7 @@ (`false`). Override to customize the cleanup. + This method cleans up resources by calling (`false`). Override to customize the cleanup. ]]> diff --git a/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml b/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml index ab777a169e3..9dc108c28b2 100644 --- a/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml +++ b/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml @@ -471,7 +471,7 @@ . + `name` must be set through a prior call to . ]]> @@ -594,7 +594,7 @@ This event provides a way for a serializer to create an object on demand, so tha ## Remarks This event is raised when serialization or deserialization is complete. -Generally, serialization code is written to emit serialization data and does not typically require state-related checking and processing. If it is necessary to maintain state data throughout serialization, data can be set and accessed by a serializer, which can listen to the event, and clear the data after serialization. Restoring the proper state after serialization is important because serializers can be reused during serialization, and leftover state data or open streams might not be correct. +Generally, serialization code is written to emit serialization data and does not typically require state-related checking and processing. If it is necessary to maintain state data throughout serialization, data can be set and accessed by a serializer, which can listen to the event, and clear the data after serialization. Restoring the proper state after serialization is important because serializers can be reused during serialization, and leftover state data or open streams might not be correct. ]]> @@ -631,7 +631,7 @@ Generally, serialization code is written to emit serialization data and does not is useful when you need to create and then name an instance of an object without using . + is useful when you need to create and then name an instance of an object without using . ]]> diff --git a/xml/System.Workflow.ComponentModel/ActivityCollection.xml b/xml/System.Workflow.ComponentModel/ActivityCollection.xml index 3dfb1b9f410..87946e1c4c1 100644 --- a/xml/System.Workflow.ComponentModel/ActivityCollection.xml +++ b/xml/System.Workflow.ComponentModel/ActivityCollection.xml @@ -1054,7 +1054,7 @@ ## Remarks For collections whose underlying store is not publicly available, the expected implementation is to return the current instance. Note that the pointer to the current instance might not be sufficient for collections that wrap other collections; those should return the underlying collection property. - Most collection classes in the namespace also implement a `Synchronized` method, which provides a synchronized wrapper around the underlying collection. However, derived classes can provide their own synchronized version of the collection using the property. The synchronizing code must perform operations on the property of the collection, not directly on the collection. This ensures proper operation of collections that are derived from other objects. Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the collection instance. + Most collection classes in the namespace also implement a `Synchronized` method, which provides a synchronized wrapper around the underlying collection. However, derived classes can provide their own synchronized version of the collection using the property. The synchronizing code must perform operations on the property of the collection, not directly on the collection. This ensures proper operation of collections that are derived from other objects. Specifically, it maintains proper synchronization with other threads that might be simultaneously modifying the collection instance. ]]> diff --git a/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml b/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml index 63e634a7747..e9654b23caf 100644 --- a/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml +++ b/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml @@ -582,7 +582,7 @@ ## Remarks In the out-of-box implementation of the , - is a no-op. If you inherit from and extend the class, you may use to perform any actions required on `items` dictated by your implementation. + is a no-op. If you inherit from and extend the class, you may use to perform any actions required on `items` dictated by your implementation. ]]> @@ -619,7 +619,7 @@ always returns `true`, which instructs the workflow run-time engine to invoke on the batch. + always returns `true`, which instructs the workflow run-time engine to invoke on the batch. ]]> diff --git a/xml/System.Workflow.Runtime.Hosting/WorkflowWebHostingModule.xml b/xml/System.Workflow.Runtime.Hosting/WorkflowWebHostingModule.xml index a0d03ca3d4c..5f24559932c 100644 --- a/xml/System.Workflow.Runtime.Hosting/WorkflowWebHostingModule.xml +++ b/xml/System.Workflow.Runtime.Hosting/WorkflowWebHostingModule.xml @@ -86,7 +86,7 @@ when you are finished using the . The method leaves the in an unusable state. After calling , you must release all references to the object so the garbage collector can reclaim the memory that the object occupied. + Call when you are finished using the . The method leaves the in an unusable state. After calling , you must release all references to the object so the garbage collector can reclaim the memory that the object occupied. > [!NOTE] > Always call `Dispose` before you release your last reference to the . Otherwise, the resources it is using are not freed until the garbage collector calls the object's `Finalize` method. @@ -125,7 +125,7 @@ to register event handling methods with specific events. + Use to register event handling methods with specific events. ]]> From 699236e2d39fa1fc3aa24bfeab12f9a8b560b6da Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 2 Apr 2026 13:30:15 -0700 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml | 4 ++-- .../SqlWorkflowPersistenceService.xml | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml index 51aa841ee57..113860a8470 100644 --- a/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml +++ b/xml/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml @@ -1162,7 +1162,7 @@ myFilters(filter) ## Remarks If the filter key of the `item` is present but is associated with data that differs from the `FilterData`, the method fails to remove the filter and returns `false`. - This method implements . + This method implements . ]]> @@ -1201,7 +1201,7 @@ myFilters(filter) . + This method implements . ]]> diff --git a/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml b/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml index e9654b23caf..bb79274238b 100644 --- a/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml +++ b/xml/System.Workflow.Runtime.Hosting/SqlWorkflowPersistenceService.xml @@ -582,7 +582,7 @@ ## Remarks In the out-of-box implementation of the , - is a no-op. If you inherit from and extend the class, you may use to perform any actions required on `items` dictated by your implementation. + is a no-op. If you inherit from and extend the class, you can use to perform any actions required on `items` dictated by your implementation. ]]> From 48bc26d59b53a7ce405584c6459847dda45086c5 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 2 Apr 2026 13:46:50 -0700 Subject: [PATCH 3/3] More # replacements --- .../WorkflowMarkupSerializationManager.xml | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml b/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml index 9dc108c28b2..149c4c89712 100644 --- a/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml +++ b/xml/System.Workflow.ComponentModel.Serialization/WorkflowMarkupSerializationManager.xml @@ -470,8 +470,7 @@ . +`name` must be set through a prior call to . ]]> @@ -594,7 +593,7 @@ This event provides a way for a serializer to create an object on demand, so tha ## Remarks This event is raised when serialization or deserialization is complete. -Generally, serialization code is written to emit serialization data and does not typically require state-related checking and processing. If it is necessary to maintain state data throughout serialization, data can be set and accessed by a serializer, which can listen to the event, and clear the data after serialization. Restoring the proper state after serialization is important because serializers can be reused during serialization, and leftover state data or open streams might not be correct. +Generally, serialization code is written to emit serialization data and does not typically require state-related checking and processing. If it is necessary to maintain state data throughout serialization, data can be set and accessed by a serializer, which can listen to the event, and clear the data after serialization. Restoring the proper state after serialization is important because serializers can be reused during serialization, and leftover state data or open streams might not be correct. ]]> @@ -631,7 +630,7 @@ Generally, serialization code is written to emit serialization data and does not is useful when you need to create and then name an instance of an object without using . + is useful when you need to create and then name an instance of an object without using . ]]>