From a8142b8858f0cd6fc1b55efca606f41213e57a0f Mon Sep 17 00:00:00 2001
From: Ryan Nowak <nowakra@gmail.com>
Date: Thu, 9 Jun 2016 11:08:16 -0700
Subject: [PATCH] Fix #4614 - update IModelBinder docs

---
 .../ModelBinding/IModelBinder.cs                   | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/IModelBinder.cs b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/IModelBinder.cs
index 948af2f376..67cfb95218 100644
--- a/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/IModelBinder.cs
+++ b/src/Microsoft.AspNetCore.Mvc.Abstractions/ModelBinding/IModelBinder.cs
@@ -16,15 +16,15 @@ namespace Microsoft.AspNetCore.Mvc.ModelBinding
         /// <param name="bindingContext">The <see cref="ModelBindingContext"/>.</param>
         /// <returns>
         /// <para>
-        /// A <see cref="Task"/> which on completion returns a <see cref="ModelBindingResult"/> which
-        /// represents the result of the model binding process.
+        /// A <see cref="Task"/> which will complete when the model binding process completes.
         /// </para>
         /// <para>
-        /// If model binding was successful, the <see cref="ModelBindingResult"/> should be a value created
-        /// with <see cref="ModelBindingResult.Success"/>. If model binding failed, the
-        /// <see cref="ModelBindingResult"/> should be a value created with <see cref="ModelBindingResult.Failed"/>.
-        /// If there was no data, or this model binder cannot handle the operation, the
-        /// <see cref="ModelBindingContext.Result"/> should be null.
+        /// If model binding was successful, the <see cref="ModelBindingContext.Result"/> should have
+        /// <see cref="ModelBindingResult.IsModelSet"/> set to <c>true</c>.
+        /// </para>
+        /// <para>
+        /// A model binder that completes successfully should set <see cref="ModelBindingContext.Result"/> to
+        /// a value returned from <see cref="ModelBindingResult.Success"/>. 
         /// </para>
         /// </returns>
         Task BindModelAsync(ModelBindingContext bindingContext);