From b581e5e1be93a7fec9e5d0caacd7dc3d61a17e8b Mon Sep 17 00:00:00 2001
From: Maira Wenzel <mairaw@microsoft.com>
Date: Mon, 9 Sep 2019 22:49:14 -0700
Subject: [PATCH 1/2] recover dropped content + edits

---
 xml/System/Range.xml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/xml/System/Range.xml b/xml/System/Range.xml
index 6632c5cd8b4..9fcb9396321 100644
--- a/xml/System/Range.xml
+++ b/xml/System/Range.xml
@@ -270,16 +270,18 @@
       <Docs>
         <param name="length">The length of the collection that the range will be used with. <paramref name="length" /> has to be a positive value.</param>
         <summary>Calculates the start offset and length of the range object using a collection length.</summary>
-        <returns>To be added.</returns>
+        <returns>The starting offset and length of the range.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-For performance reasons, we don't validate the input length parameter against negative values. It is expected that `Range` will be used with collections which always have non negative length/count. We validate the range is inside the length scope though.
+For performance reasons, the input length parameter is not validated against negative values. It is expected that `Range` will be used with collections that always have non-negative length/count. There's validation to check if the range is inside the length scope though.
 
           ]]></format>
         </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="length" /> is outside the bounds of the current range.</exception>
       </Docs>
     </Member>
     <Member MemberName="Start">

From 0aa86554eabdfa5e1e146127e010ac03f3233a15 Mon Sep 17 00:00:00 2001
From: Maira Wenzel <mairaw@microsoft.com>
Date: Mon, 9 Sep 2019 22:57:39 -0700
Subject: [PATCH 2/2] Update Range.xml

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

diff --git a/xml/System/Range.xml b/xml/System/Range.xml
index 9fcb9396321..85eba20c1f3 100644
--- a/xml/System/Range.xml
+++ b/xml/System/Range.xml
@@ -268,15 +268,15 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="length">The length of the collection that the range will be used with. <paramref name="length" /> has to be a positive value.</param>
+        <param name="length">A positive integer that represents the length of the collection that the range will be used with.</param>
         <summary>Calculates the start offset and length of the range object using a collection length.</summary>
-        <returns>The starting offset and length of the range.</returns>
+        <returns>The start offset and length of the range.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-For performance reasons, the input length parameter is not validated against negative values. It is expected that `Range` will be used with collections that always have non-negative length/count. There's validation to check if the range is inside the length scope though.
+For performance reasons, this method does't validate `length` to ensure that it is not negative. It does ensure that `length` is within the current `Range` instance.
 
           ]]></format>
         </remarks>