From af54749b5b7418e2963389a39922f96a7d900279 Mon Sep 17 00:00:00 2001
From: Jeff Handley <jeffhandley@users.noreply.github.com>
Date: Mon, 1 Sep 2025 14:03:55 -0700
Subject: [PATCH 1/2] Fix documentation for ReadOnlySequence.GetOffset

---
 xml/System.Buffers/ReadOnlySequence`1.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/xml/System.Buffers/ReadOnlySequence`1.xml b/xml/System.Buffers/ReadOnlySequence`1.xml
index 65d13bb914e..645154eee80 100644
--- a/xml/System.Buffers/ReadOnlySequence`1.xml
+++ b/xml/System.Buffers/ReadOnlySequence`1.xml
@@ -463,9 +463,9 @@
       </Parameters>
       <Docs>
         <param name="position">The <see cref="T:System.SequencePosition" /> of which to get the offset.</param>
-        <summary>Returns the offset of a <paramref name="position" /> within this sequence from the start.</summary>
-        <returns>The offset from the start of the sequence.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns the offset of a <paramref name="position" /> within this sequence.</summary>
+        <returns>The offset in the sequence.</returns>
+        <remarks>The returned offset is not a zero-based index from the start. Subtract <code>mySequence.GetOffset(mySequence.Start)</code> from the returned offset to obtain the zero-based index offset.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The position is out of range.</exception>
       </Docs>
     </Member>

From 448a89a205cfc0bb07e8c0fe3d6301d5ebcd682b Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 22 Sep 2025 15:58:23 -0700
Subject: [PATCH 2/2] Update xml/System.Buffers/ReadOnlySequence`1.xml

---
 xml/System.Buffers/ReadOnlySequence`1.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Buffers/ReadOnlySequence`1.xml b/xml/System.Buffers/ReadOnlySequence`1.xml
index 645154eee80..2ad97b98e0e 100644
--- a/xml/System.Buffers/ReadOnlySequence`1.xml
+++ b/xml/System.Buffers/ReadOnlySequence`1.xml
@@ -465,7 +465,7 @@
         <param name="position">The <see cref="T:System.SequencePosition" /> of which to get the offset.</param>
         <summary>Returns the offset of a <paramref name="position" /> within this sequence.</summary>
         <returns>The offset in the sequence.</returns>
-        <remarks>The returned offset is not a zero-based index from the start. Subtract <code>mySequence.GetOffset(mySequence.Start)</code> from the returned offset to obtain the zero-based index offset.</remarks>
+        <remarks>The returned offset is not a zero-based index from the start. To obtain the zero-based index offset, subtract <code>mySequence.GetOffset(mySequence.Start)</code> from the returned offset.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The position is out of range.</exception>
       </Docs>
     </Member>