From 0218cfb16c4637325c0e44f7a02e936cf149a44f Mon Sep 17 00:00:00 2001
From: carlossanlop <calope@microsoft.com>
Date: Tue, 3 Dec 2019 15:07:20 -0800
Subject: [PATCH 1/2] Document System.Buffers.*SpanAction delegates

---
 xml/System.Buffers/ReadOnlySpanAction`2.xml | 10 +++++-----
 xml/System.Buffers/SpanAction`2.xml         | 10 +++++-----
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/xml/System.Buffers/ReadOnlySpanAction`2.xml b/xml/System.Buffers/ReadOnlySpanAction`2.xml
index 5bc6b418e8e..9caf61e4422 100644
--- a/xml/System.Buffers/ReadOnlySpanAction`2.xml
+++ b/xml/System.Buffers/ReadOnlySpanAction`2.xml
@@ -32,11 +32,11 @@
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <typeparam name="TArg">To be added.</typeparam>
-    <param name="span">To be added.</param>
-    <param name="arg">To be added.</param>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the objects in the read-only span.</typeparam>
+    <typeparam name="TArg">The type of the object that represents the state.</typeparam>
+    <param name="span">A read-only span of objects of type <typeparamref name="T" />.</param>
+    <param name="arg">A state object of type <typeparamref name="TArg" />.</param>
+    <summary>Encapsulates a method that receives a read-only span of objects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Type>
diff --git a/xml/System.Buffers/SpanAction`2.xml b/xml/System.Buffers/SpanAction`2.xml
index 3ee1ce2dad4..d736cfb2db5 100644
--- a/xml/System.Buffers/SpanAction`2.xml
+++ b/xml/System.Buffers/SpanAction`2.xml
@@ -32,11 +32,11 @@
     <ReturnType>System.Void</ReturnType>
   </ReturnValue>
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <typeparam name="TArg">To be added.</typeparam>
-    <param name="span">To be added.</param>
-    <param name="arg">To be added.</param>
-    <summary>To be added.</summary>
+    <typeparam name="T">The type of the objects in the span.</typeparam>
+    <typeparam name="TArg">The type of the object that represents the state.</typeparam>
+    <param name="span">A span of objects of type <typeparamref name="T" />.</param>
+    <param name="arg">A state object of type <typeparamref name="TArg" />.</param>
+    <summary>Encapsulates a method that receives a span of objhects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Type>

From 239db20e6d6d114762ac34ac191d8eafbca6127e Mon Sep 17 00:00:00 2001
From: Carlos Sanchez Lopez <1175054+carlossanlop@users.noreply.github.com>
Date: Tue, 3 Dec 2019 15:31:10 -0800
Subject: [PATCH 2/2] suggestion by bartonjs

Co-Authored-By: Jeremy Barton <jbarton@microsoft.com>
---
 xml/System.Buffers/SpanAction`2.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Buffers/SpanAction`2.xml b/xml/System.Buffers/SpanAction`2.xml
index d736cfb2db5..ac62aa7f511 100644
--- a/xml/System.Buffers/SpanAction`2.xml
+++ b/xml/System.Buffers/SpanAction`2.xml
@@ -36,7 +36,7 @@
     <typeparam name="TArg">The type of the object that represents the state.</typeparam>
     <param name="span">A span of objects of type <typeparamref name="T" />.</param>
     <param name="arg">A state object of type <typeparamref name="TArg" />.</param>
-    <summary>Encapsulates a method that receives a span of objhects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
+    <summary>Encapsulates a method that receives a span of objects of type <typeparamref name="T" /> and a state object of type <typeparamref name="TArg" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Type>