From 3536cf5aade8a67bb610d29586a53b963be96a66 Mon Sep 17 00:00:00 2001
From: Ryan Nowak <nowakra@gmail.com>
Date: Sun, 25 Jun 2017 20:55:03 -0700
Subject: [PATCH] Fix #5183 - update docs of CreateWriter

---
 .../Formatters/OutputFormatterWriteContext.cs  | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/Formatters/OutputFormatterWriteContext.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/Formatters/OutputFormatterWriteContext.cs
index d9cb6cf168..fadcfc03e5 100644
--- a/src/Microsoft.AspNetCore.Mvc.Abstractions/Formatters/OutputFormatterWriteContext.cs
+++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/Formatters/OutputFormatterWriteContext.cs
@@ -34,8 +34,24 @@ namespace Microsoft.AspNetCore.Mvc.Formatters
         }
 
         /// <summary>
-        /// Gets or sets a delegate used to create a <see cref="TextWriter"/> for writing the response.
+        /// <para>
+        /// Gets or sets a delegate used to create a <see cref="TextWriter"/> for writing text to the response.
+        /// </para>
+        /// <para>
+        /// Write to <see cref="HttpResponse.Body"/> directly to write binary data to the response.
+        /// </para>
         /// </summary>
+        /// <remarks>
+        /// <para>
+        /// The <see cref="TextWriter"/> created by this delegate will encode text and write to the
+        /// <see cref="HttpResponse.Body"/> stream. Call this delegate to create a <see cref="TextWriter"/>
+        /// for writing text output to the response stream.
+        /// </para>
+        /// <para>
+        /// To implement a formatter that writes binary data to the response stream, do not use the
+        /// <see cref="WriterFactory"/> delegate, and use <see cref="HttpResponse.Body"/> instead.
+        /// </para>
+        /// </remarks>
         public virtual Func<Stream, Encoding, TextWriter> WriterFactory { get; protected set; }
     }
 }