Added documentation summary for AndTestBuilder (#13)

Author: ivaylokenov

MyWebApi/Builders/Actions/ShouldHaveModelState.cs

@@ -25,6 +25,7 @@ public IModelErrorTestBuilder<TRequestModel> ShouldHaveModelStateFor<TRequestMod
         /// <summary>
         /// Checks whether the tested action's provided model state is valid.
         /// </summary>
+        /// <returns>Test builder with And method.</returns>
         public IAndTestBuilder<TActionResult> ShouldHaveValidModelState()
         {
             this.CheckValidModelState();
@@ -34,6 +35,7 @@ public IAndTestBuilder<TActionResult> ShouldHaveValidModelState()
         /// <summary>
         /// Checks whether the tested action's provided model state is not valid.
         /// </summary>
+        /// <returns>Test builder with And method.</returns>
         public IAndTestBuilder<TActionResult> ShouldHaveInvalidModelState()
         {
             if (this.Controller.ModelState.Count == 0)

MyWebApi/Builders/And/AndTestBuilder.cs

@@ -6,14 +6,28 @@
     using Contracts.Actions;
     using Contracts.And;
 
+    /// <summary>
+    /// Class containing And() method allowing additional assertions after model state tests.
+    /// </summary>
+    /// <typeparam name="TActionResult">Result from invoked action in ASP.NET Web API controller.</typeparam>
     public class AndTestBuilder<TActionResult> : BaseTestBuilderWithActionResult<TActionResult>,
         IAndTestBuilder<TActionResult>
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AndTestBuilder{TActionResult}" /> class.
+        /// </summary>
+        /// <param name="controller">Controller on which the action will be tested.</param>
+        /// <param name="actionName">Name of the tested action.</param>
+        /// <param name="actionResult">Result from the tested action.</param>
         public AndTestBuilder(ApiController controller, string actionName, TActionResult actionResult)
             : base(controller, actionName, actionResult)
         {
         }
 
+        /// <summary>
+        /// Method allowing additional assertions after the model state tests.
+        /// </summary>
+        /// <returns>Builder for testing the action result.</returns>
         public IActionResultTestBuilder<TActionResult> And()
         {
             return new ActionResultTestBuilder<TActionResult>(this.Controller, this.ActionName, this.ActionResult);

MyWebApi/Builders/Base/BaseTestBuilderWithActionResult.cs

@@ -69,6 +69,10 @@ protected TResponseModel GetActualModel<TResponseModel>()
             }
         }
 
+        /// <summary>
+        /// Initializes new instance of builder providing And method.
+        /// </summary>
+        /// <returns>Test builder with And method.</returns>
         protected IAndTestBuilder<TActionResult> NewAndTestBuilder()
         {
             return new AndTestBuilder<TActionResult>(this.Controller, this.ActionName, this.ActionResult);

MyWebApi/Builders/Contracts/Actions/IActionResultTestBuilder.cs

@@ -25,11 +25,13 @@ public interface IActionResultTestBuilder<out TActionResult> : IBaseTestBuilderW
         /// <summary>
         /// Checks whether the tested action's provided model state is valid.
         /// </summary>
+        /// <returns>Test builder with And method.</returns>
         IAndTestBuilder<TActionResult> ShouldHaveValidModelState();
 
         /// <summary>
         /// Checks whether the tested action's provided model state is not valid.
         /// </summary>
+        /// <returns>Test builder with And method.</returns>
         IAndTestBuilder<TActionResult> ShouldHaveInvalidModelState();
 
         /// <summary>

MyWebApi/Builders/Contracts/And/IAndTestBuilder.cs

@@ -2,8 +2,16 @@
 {
     using Actions;
 
+    /// <summary>
+    /// Class containing And() method allowing additional assertions after model state tests.
+    /// </summary>
+    /// <typeparam name="TActionResult">Result from invoked action in ASP.NET Web API controller.</typeparam>
     public interface IAndTestBuilder<out TActionResult>
     {
+        /// <summary>
+        /// Method allowing additional assertions after the model state tests.
+        /// </summary>
+        /// <returns>Builder for testing the action result.</returns>
         IActionResultTestBuilder<TActionResult> And();
     }
 }