Update documentation to match code comments. (#2545)

Author: bgrainger

xml/System.Buffers/ReadOnlySequence`1.xml

@@ -460,8 +460,8 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The start index at which to begin this slice.</param>
-        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" /> , beginning at a specified index and continuing to the end of the read-only sequence.</summary>
-        <returns>To be added.</returns>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at a specified index and continuing to the end of the read-only sequence.</summary>
+        <returns>A slice starting at index <paramref name="start" /> and continuing to the end of the current read-only sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -491,8 +491,8 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The starting (inclusive) <see cref="T:System.SequencePosition" /> at which to begin this slice.</param>
-        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" /> that begins at a specified starting sequence position and continues to its end.</summary>
-        <returns>To be added.</returns>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at a specified sequence position and continuing to the end of the read-only sequence.</summary>
+        <returns>A slice starting at sequence position <paramref name="start" /> and continuing to the end of the current read-only sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -523,8 +523,8 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The index at which to begin this slice.</param>
-        <param name="length">The length of the slice</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
+        <param name="length">The length of the slice.</param>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
         <returns>A slice that consists of <paramref name="length" /> elements from the current instance starting at index <paramref name="start" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -556,9 +556,9 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The index at which to begin this slice.</param>
-        <param name="end">The end (inclusive) of the slice.</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, ending at <paramref name="end" /> (inclusive).</summary>
-        <returns>A slice that consists of items from the <paramref name="start" /> sequence position to the <paramref name="end" /> sequence position in the current read-only sequence.</returns>
+        <param name="end">The end (exclusive) <see cref="T:System.SequencePosition" /> of the slice.</param>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" /> and ending at <paramref name="end" /> (exclusive).</summary>
+        <returns>A slice that consists of items from the <paramref name="start" /> index to, but not including, the <paramref name="end" /> sequence position in the current read-only sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -591,7 +591,7 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
         <param name="start">The index at which to begin this slice.</param>
         <param name="length">The length of the slice.</param>
         <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
-        <returns>To be added.</returns>
+        <returns>A slice that consists of <paramref name="length" /> elements from the current instance starting at index <paramref name="start" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -622,9 +622,9 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The index at which to begin this slice.</param>
-        <param name="end">The end (inclusive) of the slice.</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, ending at <paramref name="end" /> (inclusive).</summary>
-        <returns>To be added.</returns>
+        <param name="end">The end (exclusive) of the slice.</param>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" /> and ending at <paramref name="end" /> (exclusive).</summary>
+        <returns>A slice that consists of items from the <paramref name="start" /> index to, but not including, the <paramref name="end" /> sequence position in the current read-only sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -656,8 +656,8 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       <Docs>
         <param name="start">The starting (inclusive) <see cref="T:System.SequencePosition" /> at which to begin this slice.</param>
         <param name="length">The length of the slice.</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at '<paramref name="start" />, with <paramref name="length" /> items.</summary>
-        <returns>To be added.</returns>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
+        <returns>A slice that consists of <paramref name="length" /> elements from the current instance starting at sequence position <paramref name="start" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -689,8 +689,8 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       <Docs>
         <param name="start">The starting (inclusive) <see cref="T:System.SequencePosition" /> at which to begin this slice.</param>
         <param name="length">The length of the slice.</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
-        <returns>To be added.</returns>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, with <paramref name="length" /> items.</summary>
+        <returns>A slice that consists of <paramref name="length" /> elements from the current instance starting at sequence position <paramref name="start" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -721,9 +721,9 @@ The consumer is expected to manage the lifetime of memory until <see cref="T:Sys
       </Parameters>
       <Docs>
         <param name="start">The starting (inclusive) <see cref="T:System.SequencePosition" /> at which to begin this slice.</param>
-        <param name="end">The ending (inclusive) <see cref="T:System.SequencePosition" /> of the slice.</param>
-        <summary>Forms a slice out of the given <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" />, ending at <paramref name="end" /> (inclusive).</summary>
-        <returns>To be added.</returns>
+        <param name="end">The ending (exclusive) <see cref="T:System.SequencePosition" /> of the slice.</param>
+        <summary>Forms a slice out of the current <see cref="T:System.Buffers.ReadOnlySequence`1" />, beginning at <paramref name="start" /> and ending at <paramref name="end" /> (exclusive).</summary>
+        <returns>A slice that consists of items from the <paramref name="start" /> sequence position to, but not including, the <paramref name="end" /> sequence position in the current read-only sequence.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>