From 4a73858ded6d12efefe1401d99129403c0df363c Mon Sep 17 00:00:00 2001
From: Jose Perez Rodriguez <joperezr@microsoft.com>
Date: Wed, 8 Sep 2021 15:47:23 -0700
Subject: [PATCH 1/3] Add docs for missing members in System.CodeDom

---
 xml/System.CodeDom.Compiler/IndentedTextWriter.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
index 9ef9fd8cbe2..703655362d4 100644
--- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
+++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
@@ -307,7 +307,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -431,8 +431,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Clears all buffers for this <see cref="T:System.CodeDom.Compiler.IndentedTextWriter" /> asynchronously and causes any buffered data to be written to the underlying device.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the operation</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2225,8 +2225,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Asynchronously writes the line terminator to the underlying <see cref="T:System.IO.TextWriter" />.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From f7ad989d71f82ee21c26902b8c1f22f27265ab37 Mon Sep 17 00:00:00 2001
From: Jose Perez Rodriguez <joperezr@microsoft.com>
Date: Wed, 8 Sep 2021 15:57:08 -0700
Subject: [PATCH 2/3] Add missing return statement

---
 xml/System.CodeDom.Compiler/IndentedTextWriter.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
index 703655362d4..1084dad804d 100644
--- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
+++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
@@ -308,7 +308,7 @@
       <Parameters />
       <Docs>
         <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> representing the operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From 2b5b56c4d8f47ca87df2e9296ec5f685e53d6a8e Mon Sep 17 00:00:00 2001
From: Jose Perez Rodriguez <joperezr@microsoft.com>
Date: Wed, 8 Sep 2021 16:05:13 -0700
Subject: [PATCH 3/3] Apply suggestions from code review

Co-authored-by: Carlos Sanchez <1175054+carlossanlop@users.noreply.github.com>
---
 xml/System.CodeDom.Compiler/IndentedTextWriter.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
index 1084dad804d..8eec2b13254 100644
--- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
+++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml
@@ -308,7 +308,7 @@
       <Parameters />
       <Docs>
         <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
-        <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> representing the operation.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> representing the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -432,7 +432,7 @@
       <Parameters />
       <Docs>
         <summary>Clears all buffers for this <see cref="T:System.CodeDom.Compiler.IndentedTextWriter" /> asynchronously and causes any buffered data to be written to the underlying device.</summary>
-        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the operation</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous flush operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2226,7 +2226,7 @@
       <Parameters />
       <Docs>
         <summary>Asynchronously writes the line terminator to the underlying <see cref="T:System.IO.TextWriter" />.</summary>
-        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
+        <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous line writing operation.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>