Added xml comments for ActionResultAssertions and AssertionsExtensions.

Author: kevinkuszyk

src/FluentAssertions.Mvc3/ActionResultAssertions.cs

@@ -6,24 +6,43 @@
 
 namespace FluentAssertions.Mvc
 {
+    /// <summary>
+    /// Contains a number of methods to assert that an <see cref="ActionResult"/> is in the expected state.
+    /// </summary>
     [DebuggerNonUserCode]
 	public class ActionResultAssertions : ObjectAssertions
 	{
         public struct Constants
         {
             public const string CommonFailMessage = "Expected ActionResult to be {0}{reason}, but found {1}";
         }
-        
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="T:ActionResultAssertions" /> class.
+        /// </summary>
 		public ActionResultAssertions (ActionResult subject) : base(subject)
 		{
 			Subject = subject;
 		}
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="ContentResult"/>.
+        /// </summary>
         public ContentResultAssertions BeContentResult()
         {
             return BeContentResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="ContentResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public ContentResultAssertions BeContentResult(string reason, params object[] reasonArgs)
         {
             Execute.Verification
@@ -34,11 +53,24 @@ public ContentResultAssertions BeContentResult(string reason, params object[] re
             return new ContentResultAssertions(Subject as ContentResult);
         }
 
+        /// <summary>
+        /// Asserts that the subject is an <see cref="EmptyResult"/>.
+        /// </summary>
         public EmptyResult BeEmptyResult()
         {
             return BeEmptyResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is an <see cref="EmptyResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public EmptyResult BeEmptyResult(string reason, params object[] reasonArgs)
         {
             Execute.Verification
@@ -49,11 +81,24 @@ public EmptyResult BeEmptyResult(string reason, params object[] reasonArgs)
             return Subject as EmptyResult;
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="RedirectToRouteResult"/>.
+        /// </summary>
         public RedirectToRouteAssertions BeRedirectToRouteResult()
         {
             return BeRedirectToRouteResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="RedirectToRouteResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public RedirectToRouteAssertions BeRedirectToRouteResult(string reason, params object[] reasonArgs)
         {
             Execute.Verification
@@ -64,11 +109,24 @@ public RedirectToRouteAssertions BeRedirectToRouteResult(string reason, params o
             return new RedirectToRouteAssertions(Subject as RedirectToRouteResult);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="PartialViewResult"/>.
+        /// </summary>
         public PartialViewResultAssertions BePartialViewResult()
         {
             return BePartialViewResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="PartialViewResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public PartialViewResultAssertions BePartialViewResult(string reason, params object[] reasonArgs)
         {
             Execute.Verification
@@ -79,11 +137,24 @@ public PartialViewResultAssertions BePartialViewResult(string reason, params obj
             return new PartialViewResultAssertions(Subject as PartialViewResult);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="RedirectResult"/>.
+        /// </summary>
         public RedirectResultAssertions BeRedirectResult()
         {
             return BeRedirectResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="RedirectResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public RedirectResultAssertions BeRedirectResult(string reason, params object[] reasonArgs)
         {
             Execute.Verification
@@ -94,11 +165,24 @@ public RedirectResultAssertions BeRedirectResult(string reason, params object[]
             return new RedirectResultAssertions(Subject as RedirectResult);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="ViewResult"/>.
+        /// </summary>
         public ViewResultAssertions BeViewResult()
         {
             return BeViewResult(string.Empty, null);
         }
 
+        /// <summary>
+        /// Asserts that the subject is a <see cref="ViewResult"/>.
+        /// </summary>
+        /// <param name="reason">
+        /// A formatted phrase as is supported by <see cref="string.Format(string,object[])" /> explaining why the assertion 
+        /// is needed. If the phrase does not start with the word <i>because</i>, it is prepended automatically.
+        /// </param>
+        /// <param name="reasonArgs">
+        /// Zero or more objects to format using the placeholders in <see cref="reason" />.
+        /// </param>
         public ViewResultAssertions BeViewResult(string reason, params object[] reasonArgs)
 		{
 			Execute.Verification

src/FluentAssertions.Mvc3/AssertionsExtensions.cs

@@ -7,14 +7,25 @@
 
 namespace FluentAssertions.Mvc
 {
+    /// <summary>
+    /// Contains extension methods for custom assertions in unit tests.
+    /// </summary>
     [DebuggerNonUserCode]
 	public static class AssertionsExtensions
 	{
+        /// <summary>
+        /// Returns an <see cref="ActionResultAssertions"/> object that can be used to assert the
+        /// current <see cref="ActionResult"/>.
+        /// </summary>
 		public static ActionResultAssertions Should (this ActionResult actual)
 		{
 			return new ActionResultAssertions (actual);
 		}
 
+        /// <summary>
+        /// Returns an <see cref="RouteDataAssertions"/> object that can be used to assert the
+        /// current <see cref="RouteData"/>.
+        /// </summary>
         public static RouteDataAssertions Should(this RouteData routeData)
         {
             return new RouteDataAssertions(routeData);