Cleaning up the docs

Author: harshgMSFT

src/Microsoft.AspNet.Mvc.Core/Formatters/IOutputFormatter.cs

@@ -18,38 +18,22 @@ namespace Microsoft.AspNet.Mvc
     /// </summary>
     public interface IOutputFormatter
     {
-        /// <summary>
-        /// Gets the mutable collection of character encodings supported by
-        /// this <see cref="IOutputFormatter"/> instance. The encodings are
-        /// used when writing the data.
-        /// </summary>
-        List<Encoding> SupportedEncodings { get; }
-
-        /// <summary>
-        /// Gets the mutable collection of <see cref="MediaTypeHeaderValue"/> elements supported by
-        /// this <see cref="IOutputFormatter"/> instance.
-        /// </summary>
-        List<MediaTypeHeaderValue> SupportedMediaTypes { get; }
-
         /// <summary>
         /// Determines whether this <see cref="IOutputFormatter"/> can serialize
         /// an object of the specified type.
         /// </summary>
         /// <param name="context">The formatter context associated with the call.</param>
         /// <param name="contentType">The desired contentType on the response.</param>
-        /// <remarks>
-        /// Subclasses can override this method to determine if the given content can be handled by this formatter.
-        ///  Subclasses should call the base implementation.
-        /// </remarks>
-        /// <returns>True if this <see cref="IOutputFormatter"/> is able to serialize the object
-        /// represent by <paramref name="context"/>'s ObjectResult and supports the passed in 
-        /// <paramref name="contentType"/>. 
+        /// <returns>True if this <see cref="IOutputFormatter"/> supports the passed in 
+        /// <paramref name="contentType"/> and is able to serialize the object
+        /// represent by <paramref name="context"/>'s Object property.
         /// False otherwise.</returns>
         bool CanWriteResult(OutputFormatterContext context, MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Writes given <paramref name="value"/> to the HttpResponse <paramref name="response"/> body stream. 
+        /// Writes the object represented by <paramref name="context"/>'s Object property.
         /// </summary>
+        /// <param name="context">The formatter context associated with the call.</param>
         /// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
         /// <returns>A Task that serializes the value to the <paramref name="context"/>'s response message.</returns>
         Task WriteAsync(OutputFormatterContext context, CancellationToken cancellationToken);

src/Microsoft.AspNet.Mvc.Core/Formatters/OutputFormatter.cs

@@ -17,10 +17,17 @@ namespace Microsoft.AspNet.Mvc
     /// </summary>
     public abstract class OutputFormatter : IOutputFormatter
     {
-        /// <inheritdoc />
+        /// <summary>
+        /// Gets the mutable collection of character encodings supported by
+        /// this <see cref="OutputFormatter"/> instance. The encodings are
+        /// used when writing the data.
+        /// </summary>
         public List<Encoding> SupportedEncodings { get; private set; }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Gets the mutable collection of <see cref="MediaTypeHeaderValue"/> elements supported by
+        /// this <see cref="OutputFormatter"/> instance.
+        /// </summary>
         public List<MediaTypeHeaderValue> SupportedMediaTypes { get; private set; }
 
         /// <summary>
@@ -128,7 +135,7 @@ public virtual void WriteResponseContentHeaders(OutputFormatterContext context)
         /// <summary>
         /// Writes the response body.
         /// </summary>
-        /// <param name="context">The formatter context assoicated with the call.</param>
+        /// <param name="context">The formatter context associated with the call.</param>
         /// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
         /// <returns></returns>
         public abstract Task WriteResponseBodyAsync(OutputFormatterContext context,