From 9aa888657ce56e3a535b522cffaffe695675dc3b Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Tue, 22 Apr 2025 16:52:23 -0700
Subject: [PATCH 1/2] add language slugs

---
 .../AuthenticationHeaderValue.xml             | 36 ++++++++++---------
 xml/System.Net.Http/HttpClientHandler.xml     |  2 +-
 xml/System.Net.Http/SocketsHttpHandler.xml    |  1 +
 3 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/xml/System.Net.Http.Headers/AuthenticationHeaderValue.xml b/xml/System.Net.Http.Headers/AuthenticationHeaderValue.xml
index d56ae13e164..f640686efe1 100644
--- a/xml/System.Net.Http.Headers/AuthenticationHeaderValue.xml
+++ b/xml/System.Net.Http.Headers/AuthenticationHeaderValue.xml
@@ -55,11 +55,11 @@
   <Docs>
     <summary>Represents authentication information in Authorization, ProxyAuthorization, WWW-Authenticate, and Proxy-Authenticate header values.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The <xref:System.Net.Http.Headers.AuthenticationHeaderValue> class provides support for the Authorization, ProxyAuthorization, WWW-Authenticate, and Proxy-Authenticate HTTP header values 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.AuthenticationHeaderValue> class provides support for the Authorization, ProxyAuthorization, WWW-Authenticate, and Proxy-Authenticate HTTP header values as defined in [RFC 2616](https://go.microsoft.com/fwlink/?LinkID=241642) by the IETF.
+
  ]]></format>
     </remarks>
   </Docs>
@@ -111,8 +111,9 @@
         <param name="scheme">The scheme to use for authorization.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[ 
+          <format type="text/markdown"><![CDATA[
 Example:
+
 ```csharp
 HttpClient client = new HttpClient();
 client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(ACCESS_TOKEN);
@@ -124,7 +125,8 @@ client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(ACCES
 ```
 
 Will produce the following header:
-```
+
+```txt
 Authorization: ACCESS_TOKEN
 ```
 
@@ -177,8 +179,9 @@ Authorization: ACCESS_TOKEN
         <param name="parameter">The credentials containing the authentication information of the user agent for the resource being requested.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> class.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[ 
+          <format type="text/markdown"><![CDATA[
 Example:
+
 ```csharp
 HttpClient client = new HttpClient();
 client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", ACCESS_TOKEN);
@@ -190,7 +193,8 @@ client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bear
 ```
 
  Will produce the following header:
-```
+
+```txt
 Authorization: Bearer ACCESS_TOKEN
 ```
  ]]></format>
@@ -283,13 +287,13 @@ Authorization: Bearer ACCESS_TOKEN
         <summary>Serves as a hash function for an  <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> 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.AuthenticationHeaderValue.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.AuthenticationHeaderValue.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/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml
index 26e77c2c72c..a173f560076 100644
--- a/xml/System.Net.Http/HttpClientHandler.xml
+++ b/xml/System.Net.Http/HttpClientHandler.xml
@@ -506,7 +506,7 @@ If the <xref:System.Net.Http.HttpClientHandler.UseDefaultCredentials> property h
 
  The <xref:System.Net.Http.HttpClientHandler.DangerousAcceptAnyServerCertificateValidator%2A> property addresses this limitation. The delegate returned by the <xref:System.Net.Http.HttpClientHandler.DangerousAcceptAnyServerCertificateValidator%2A> property can be assigned to the <xref:System.Net.Http.HttpClientHandler.ServerCertificateCustomValidationCallback%2A> property, as the following example does:
 
-```cs
+ ```csharp
 handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator;
 ```
 
diff --git a/xml/System.Net.Http/SocketsHttpHandler.xml b/xml/System.Net.Http/SocketsHttpHandler.xml
index e9df0850c22..4a5296d7cfc 100644
--- a/xml/System.Net.Http/SocketsHttpHandler.xml
+++ b/xml/System.Net.Http/SocketsHttpHandler.xml
@@ -54,6 +54,7 @@ If this change is undesirable and you are on .NET Core 2.1-3.1, you can configur
    ```vb
    AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", False)
    ```
+   
 - By defining the `System.Net.Http.UseSocketsHttpHandler` switch in the *.netcore.runtimeconfig.json* configuration file:
 
   ```json

From da2259e00154dbf23f10501b6a8b871642dc63c0 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Wed, 23 Apr 2025 13:23:43 -0700
Subject: [PATCH 2/2] Update xml/System.Net.Http/HttpClientHandler.xml

Co-authored-by: Miha Zupan <mihazupan.zupan1@gmail.com>
---
 xml/System.Net.Http/HttpClientHandler.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml
index a173f560076..5bb51b4934b 100644
--- a/xml/System.Net.Http/HttpClientHandler.xml
+++ b/xml/System.Net.Http/HttpClientHandler.xml
@@ -506,7 +506,7 @@ If the <xref:System.Net.Http.HttpClientHandler.UseDefaultCredentials> property h
 
  The <xref:System.Net.Http.HttpClientHandler.DangerousAcceptAnyServerCertificateValidator%2A> property addresses this limitation. The delegate returned by the <xref:System.Net.Http.HttpClientHandler.DangerousAcceptAnyServerCertificateValidator%2A> property can be assigned to the <xref:System.Net.Http.HttpClientHandler.ServerCertificateCustomValidationCallback%2A> property, as the following example does:
 
- ```csharp
+```csharp
 handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator;
 ```