Merge pull request #11969 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Net.Http.Headers/NameValueHeaderValue.xml

@@ -73,7 +73,7 @@
         <AssemblyVersion>4.2.0.0</AssemblyVersion>
       </AssemblyInfo>
       <Docs>
-        <summary>Initializes a new instance of the CLASS class.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> class.</summary>
       </Docs>
     </MemberGroup>
     <Member MemberName=".ctor">

xml/System.Reflection/ParameterInfo.xml

@@ -220,17 +220,17 @@
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- This method utilizes the <xref:System.Reflection.ParameterInfo.AttrsImpl> method.
-
- To get the <xref:System.Reflection.ParameterInfo> array, first get the method or the constructor and then call <xref:System.Reflection.MethodBase.GetParameters%2A?displayProperty=nameWithType>.
 
+This method utilizes the <xref:System.Reflection.ParameterInfo.AttrsImpl> method.
 
+To get the <xref:System.Reflection.ParameterInfo> array, first get the method or the constructor and then call <xref:System.Reflection.MethodBase.GetParameters%2A?displayProperty=nameWithType>.
 
 ## Examples
- The following example defines a method with three parameters. It uses the <xref:System.Reflection.ParameterInfo.Attributes%2A> property to get the attributes of the second parameter and display them at the console.
 
- :::code language="csharp" source="~/snippets/csharp/System.Reflection/ParameterInfo/Attributes/parameterinfo_attributes1.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/System.Reflection/ParameterInfo/Attributes/parameterinfo_attributes1.vb" id="Snippet1":::
+The following example defines a method with three parameters. It uses the <xref:System.Reflection.ParameterInfo.Attributes%2A> property to get the attributes of each parameter and display them in the console.
+
+:::code language="csharp" source="~/snippets/csharp/System.Reflection/ParameterInfo/Attributes/parameterinfo_attributes1.cs" id="Snippet1":::
+:::code language="vb" source="~/snippets/visualbasic/System.Reflection/ParameterInfo/Attributes/parameterinfo_attributes1.vb" id="Snippet1":::
 
  ]]></format>
         </remarks>

xml/System.Xml.Serialization/SoapIncludeAttribute.xml

@@ -196,15 +196,9 @@
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
-## Remarks  
- Apply multiple instances of the <xref:System.Xml.Serialization.SoapIncludeAttribute> to a field or property that returns either an array of objects, an <xref:System.Collections.ArrayList> that contains a collection of objects, or an object that can return multiple types. Set the <xref:System.Xml.Serialization.SoapIncludeAttribute.Type%2A> property for each type that you want the field or property to contain.  
-  
-   
-  
-## Examples  
- The following example applies the <xref:System.Xml.Serialization.SoapIncludeAttribute> twice to an XML Web services method. The method returns an object of type `Vehicle` (a base class). The <xref:System.Xml.Serialization.SoapIncludeAttribute> allows the method to return instances of classes derived from the `Vehicle` class.  
-  
-  
+## Remarks
+
+Apply multiple instances of the <xref:System.Xml.Serialization.SoapIncludeAttribute> to a field or property that returns either an array of objects, an <xref:System.Collections.ArrayList> that contains a collection of objects, or an object that can return multiple types. Set the <xref:System.Xml.Serialization.SoapIncludeAttribute.Type%2A> property for each type that you want the field or property to contain. 
   
  ]]></format>
         </remarks>