Added documentation summary for IAggregateExceptionTestBuilder (#73)

Author: ivaylokenov

src/MyWebApi/Builders/Contracts/ExceptionErrors/IAggregateExceptionTestBuilder.cs

@@ -16,8 +16,16 @@
 
 namespace MyWebApi.Builders.Contracts.ExceptionErrors
 {
+    /// <summary>
+    /// Used for testing AggregateException.
+    /// </summary>
     public interface IAggregateExceptionTestBuilder : IBaseExceptionTestBuilder
     {
+        /// <summary>
+        /// Tests whether AggregateException contains inner exception of the provided type.
+        /// </summary>
+        /// <typeparam name="TInnerException">Expected inner exception type.</typeparam>
+        /// <returns>The same aggregate exception test builder.</returns>
         IAndAggregateExceptionTestBuilder ContainingInnerExceptionOfType<TInnerException>();
     }
 }

src/MyWebApi/Builders/Contracts/ExceptionErrors/IAndAggregateExceptionTestBuilder.cs

@@ -16,8 +16,15 @@
 
 namespace MyWebApi.Builders.Contracts.ExceptionErrors
 {
+    /// <summary>
+    /// Used for adding AndAlso() method to the aggregate exception tests.
+    /// </summary>
     public interface IAndAggregateExceptionTestBuilder : IAggregateExceptionTestBuilder
     {
+        /// <summary>
+        /// AndAlso method for better readability when chaining aggregate exception tests.
+        /// </summary>
+        /// <returns>The same aggregate exception test builder.</returns>
         IAggregateExceptionTestBuilder AndAlso();
     }
 }

src/MyWebApi/Builders/Contracts/ExceptionErrors/IBaseExceptionTestBuilder.cs

@@ -18,6 +18,9 @@ namespace MyWebApi.Builders.Contracts.ExceptionErrors
 {
     using Base;
 
+    /// <summary>
+    /// Used for testing expected exception messages.
+    /// </summary>
     public interface IBaseExceptionTestBuilder : IBaseTestBuilder
     {
         /// <summary>

src/MyWebApi/Builders/ExceptionErrors/AggregateExceptionTestBuilder.cs

@@ -24,10 +24,19 @@ namespace MyWebApi.Builders.ExceptionErrors
     using Exceptions;
     using Utilities;
 
+    /// <summary>
+    /// Used for testing AggregateException.
+    /// </summary>
     public class AggregateExceptionTestBuilder : ExceptionTestBuilder, IAndAggregateExceptionTestBuilder
     {
         private readonly AggregateException aggregateException;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AggregateExceptionTestBuilder" /> 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="caughtException">Actual received aggregate exception.</param>
         public AggregateExceptionTestBuilder(
             ApiController controller,
             string actionName,
@@ -37,6 +46,11 @@ public AggregateExceptionTestBuilder(
             this.aggregateException = caughtException;
         }
 
+        /// <summary>
+        /// Tests whether AggregateException contains inner exception of the provided type.
+        /// </summary>
+        /// <typeparam name="TInnerException">Expected inner exception type.</typeparam>
+        /// <returns>The same aggregate exception test builder.</returns>
         public IAndAggregateExceptionTestBuilder ContainingInnerExceptionOfType<TInnerException>()
         {
             var expectedInnerExceptionType = typeof(TInnerException);
@@ -53,6 +67,10 @@ public IAndAggregateExceptionTestBuilder ContainingInnerExceptionOfType<TInnerEx
             return this;
         }
 
+        /// <summary>
+        /// AndAlso method for better readability when chaining aggregate exception tests.
+        /// </summary>
+        /// <returns>The same aggregate exception test builder.</returns>
         public new IAggregateExceptionTestBuilder AndAlso()
         {
             return this;