From 8467cec289f91cd59e27fd358a2359c19582e4a4 Mon Sep 17 00:00:00 2001
From: Eric StJohn <ericstj@microsoft.com>
Date: Mon, 19 May 2025 14:12:17 -0700
Subject: [PATCH 1/2] Add documentation for System.Text.Ascii class (#11318)

* Add documentation for System.Text.Ascii class

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>

---------

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 xml/System.Text/Ascii.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/xml/System.Text/Ascii.xml b/xml/System.Text/Ascii.xml
index a878643cffb..e4215063c4f 100644
--- a/xml/System.Text/Ascii.xml
+++ b/xml/System.Text/Ascii.xml
@@ -16,8 +16,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Provides helper methods for working with ASCII-encoded text as bytes or characters.</summary>
+    <remarks>For APIs that take both a source and a destination buffer, the behavior of the method is undefined if the source and destination buffers overlap, unless the description specifies otherwise. The behavior of all APIs is undefined if another thread mutates the buffers while these APIs are operating on them. All case-conversion APIs are culture-unaware.</remarks>
   </Docs>
   <Members>
     <Member MemberName="Equals">

From 82983a96f6db5a4e6982a224174c195842cfe41c Mon Sep 17 00:00:00 2001
From: Radek Zikmund <32671551+rzikm@users.noreply.github.com>
Date: Tue, 20 May 2025 08:16:01 +0200
Subject: [PATCH 2/2] Fix wording around BitIncrement and BitDecrement (#11315)

---
 xml/System/Double.xml | 6 +++---
 xml/System/Single.xml | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/xml/System/Double.xml b/xml/System/Double.xml
index c65f59d706e..49786fbe5be 100644
--- a/xml/System/Double.xml
+++ b/xml/System/Double.xml
@@ -872,8 +872,8 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise decremented.</param>
-        <summary>Decrements a value to the smallest value that compares less than a given value.</summary>
-        <returns>The smallest value that compares less than <paramref name="x" />.</returns>
+        <summary>Returns the largest value that compares less than a specified value.</summary>
+        <returns>The largest value that compares less than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitDecrement(`0)" />
       </Docs>
@@ -910,7 +910,7 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise incremented.</param>
-        <summary>Increments a value to the smallest value that compares greater than a given value.</summary>
+        <summary>Returns the smallest value that compares greater than a specified value.</summary>
         <returns>The smallest value that compares greater than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitIncrement(`0)" />
diff --git a/xml/System/Single.xml b/xml/System/Single.xml
index 0d0c8bc319e..c44df155936 100644
--- a/xml/System/Single.xml
+++ b/xml/System/Single.xml
@@ -870,8 +870,8 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise decremented.</param>
-        <summary>Decrements a value to the smallest value that compares less than a given value.</summary>
-        <returns>The smallest value that compares less than <paramref name="x" />.</returns>
+        <summary>Returns the largest value that compares less than a specified value.</summary>
+        <returns>The largest value that compares less than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitDecrement(`0)" />
       </Docs>
@@ -908,7 +908,7 @@ This computes `arctan(x) / π` in the interval `[-0.5, +0.5]`.
       </Parameters>
       <Docs>
         <param name="x">The value to be bitwise incremented.</param>
-        <summary>Increments a value to the smallest value that compares greater than a given value.</summary>
+        <summary>Returns the smallest value that compares greater than a specified value.</summary>
         <returns>The smallest value that compares greater than <paramref name="x" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc cref="M:System.Numerics.IFloatingPointIeee754`1.BitIncrement(`0)" />