dotnet · dotnet-policy-service · Mar 30, 2025 · Mar 30, 2025
diff --git a/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml b/xml/System.Net.Http.Headers/ContentDispositionHeaderValue.xml
@@ -55,17 +55,17 @@
   <Docs>
     <summary>Represents the value of the Content-Disposition header.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The Content-Disposition header is normally used for working with file uploads and downloads. The format differs from other headers in that it is a single header with a disposition type followed by a list of parameters, some of which are well defined.  
-  
- This header is used in two different contexts:  
-  
-1.  A MIME header for nested body content in the <xref:System.Net.Http.MultipartFormDataContent> class. For more information, see IETF RFC 2183.  
-  
-2.  An HTTP header in <xref:System.Net.Http.Headers.HttpContentHeaders> class. For more information, see IETF RFC 6266.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The Content-Disposition header is normally used for working with file uploads and downloads. The format differs from other headers in that it is a single header with a disposition type followed by a list of parameters, some of which are well defined.
+
+ This header is used in two different contexts:
+
+1.  A MIME header for nested body content in the <xref:System.Net.Http.MultipartFormDataContent> class. For more information, see IETF RFC 2183.
+
+2.  An HTTP header in <xref:System.Net.Http.Headers.HttpContentHeaders> class. For more information, see IETF RFC 6266.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -234,11 +234,11 @@
         <summary>The disposition type for a content body part.</summary>
         <value>The disposition type.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A body part should be marked with a <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.DispositionType%2A> property of "inline" if it is intended to be   displayed automatically upon display of the message. A body part can be designated with a <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.DispositionType%2A> property of "attachment" to indicate that they are   separate from the main body of the HTTP request or response.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A body part should be marked with a <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.DispositionType%2A> property of "inline" if it is intended to be   displayed automatically upon display of the message. A body part can be designated with a <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.DispositionType%2A> property of "attachment" to indicate that they are   separate from the main body of the HTTP request or response.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -329,11 +329,11 @@
         <summary>A suggestion for how to construct a filename for   storing the message payload to be used if the entity is   detached and stored in a separate file.</summary>
         <value>A suggested filename.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileName%2A> property uses MIME encoding for non-ascii characters.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileName%2A> property uses MIME encoding for non-ascii characters.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -374,11 +374,11 @@
         <summary>A suggestion for how to construct filenames for   storing message payloads to be used if the entities are    detached and stored in a separate files.</summary>
         <value>A suggested filename of the form filename*.</value>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> property uses IETF RFC 5987 encoding. The <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileName%2A> and  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> properties differ only in that <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> uses the encoding defined in IETF RFC 5987, allowing the use   of characters not present in the ISO-8859-1 character set.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> property uses IETF RFC 5987 encoding. The <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileName%2A> and  <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> properties differ only in that <xref:System.Net.Http.Headers.ContentDispositionHeaderValue.FileNameStar%2A> uses the encoding defined in IETF RFC 5987, allowing the use   of characters not present in the ISO-8859-1 character set.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -419,13 +419,13 @@
         <summary>Serves as a hash function for an  <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" /> object.</summary>
         <returns>A hash code for the current object.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.  
-  
- The <xref:System.Net.Http.Headers.ContentDispositionHeaderValue> method is suitable for use in hashing algorithms and data structures such as a hash table.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.
+
+ The <xref:System.Net.Http.Headers.ContentDispositionHeaderValue> method is suitable for use in hashing algorithms and data structures such as a hash table.
+
  ]]></format>
         </remarks>
       </Docs>
@@ -462,7 +462,7 @@
         <ReturnType>System.Nullable&lt;System.DateTimeOffset&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The date at   which the file was last modified.</summary>
+        <summary>The date when the file was last modified.</summary>
         <value>The file modification date.</value>
         <remarks>To be added.</remarks>
       </Docs>

diff --git a/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml b/xml/System.Net.Http.Headers/ProductInfoHeaderValue.xml
@@ -53,15 +53,15 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Represents a value which can either be a product or a comment in a User-Agent header.</summary>
+    <summary>Represents a value that can either be a product or a comment in a User-Agent header.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Http.Headers.ProductInfoHeaderValue> class provides support for the product and comment tokens values used in  a User-Agent header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.  
-  
- The User-Agent field contains information about the user agent originating the request. The field can contain multiple product tokens and comments identifying the user agent and any sub-products.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Http.Headers.ProductInfoHeaderValue> class provides support for the product and comment tokens values used in  a User-Agent header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.
+
+ The User-Agent field contains information about the user agent originating the request. The field can contain multiple product tokens and comments identifying the user agent and any sub-products.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -329,13 +329,13 @@
         <summary>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> object.</summary>
         <returns>A hash code for the current object.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.  
-  
- The <xref:System.Net.Http.Headers.ProductInfoHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.
+
+ The <xref:System.Net.Http.Headers.ProductInfoHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.
+
  ]]></format>
         </remarks>
       </Docs>

diff --git a/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml b/xml/System.Net.Http.Headers/RangeConditionHeaderValue.xml
@@ -53,13 +53,13 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Represents an If-Range header value which can either be a date/time or an entity-tag value.</summary>
+    <summary>Represents an If-Range header value that can either be a date/time or an entity-tag value.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Http.Headers.RangeConditionHeaderValue> class provides support for the If-Range header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Http.Headers.RangeConditionHeaderValue> class provides support for the If-Range header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -354,13 +354,13 @@
         <summary>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> object.</summary>
         <returns>A hash code for the current object.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.  
-  
- The <xref:System.Net.Http.Headers.RangeConditionHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.
+
+ The <xref:System.Net.Http.Headers.RangeConditionHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.
+
  ]]></format>
         </remarks>
       </Docs>

diff --git a/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml b/xml/System.Net.Http.Headers/RetryConditionHeaderValue.xml
@@ -47,13 +47,13 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>Represents a Retry-After header value which can either be a date/time or a timespan value.</summary>
+    <summary>Represents a Retry-After header value that can either be a date/time or a timespan value.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Http.Headers.RetryConditionHeaderValue> class provides support for the Retry-After header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ The <xref:System.Net.Http.Headers.RetryConditionHeaderValue> class provides support for the Retry-After header as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -304,13 +304,13 @@
         <summary>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> object.</summary>
         <returns>A hash code for the current object.</returns>
         <remarks>
-          <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.  
-  
- The <xref:System.Net.Http.Headers.RetryConditionHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.  
-  
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.
+
+ The <xref:System.Net.Http.Headers.RetryConditionHeaderValue.GetHashCode%2A> method is suitable for use in hashing algorithms and data structures such as a hash table.
+
  ]]></format>
         </remarks>
       </Docs>