Added documentation summary on the mocked application builder

Author: ivaylokenov

src/MyTested.Mvc/Internal/Application/MockedApplicationBuilder.cs

@@ -10,25 +10,40 @@
     using Microsoft.AspNetCore.Http.Features;
     using Microsoft.AspNetCore.Routing;
 
+    /// <summary>
+    /// Mocked <see cref="IApplicationBuilder"/>. Used for extracting registered routes.
+    /// </summary>
     public class MockedApplicationBuilder : IApplicationBuilder
     {
         private const string ServerFeaturesPropertyName = "server.Features";
         private const string ApplicationServicesPropertyName = "application.Services";
 
         private readonly IList<Func<RequestDelegate, RequestDelegate>> components = new List<Func<RequestDelegate, RequestDelegate>>();
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="MockedApplicationBuilder"/> class.
+        /// </summary>
+        /// <param name="serviceProvider">Application service provider.</param>
         public MockedApplicationBuilder(IServiceProvider serviceProvider)
         {
             this.Properties = new Dictionary<string, object>();
             this.Routes = new RouteCollection();
             this.ApplicationServices = serviceProvider;
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="MockedApplicationBuilder"/> class.
+        /// </summary>
+        /// <param name="builder">Application builder to copy properties from.</param>
         public MockedApplicationBuilder(IApplicationBuilder builder)
         {
             this.Properties = builder.Properties;
         }
-        
+
+        /// <summary>
+        /// Gets or sets the current application services.
+        /// </summary>
+        /// <value>Result of <see cref="IServiceProvider"/> type.</value>
         public IServiceProvider ApplicationServices
         {
             get
@@ -42,6 +57,10 @@ public IServiceProvider ApplicationServices
             }
         }
 
+        /// <summary>
+        /// Gets the current server feature collection. Not used in the actual testing.
+        /// </summary>
+        /// <value>Result of <see cref="IFeatureCollection"/> type.</value>
         public IFeatureCollection ServerFeatures
         {
             get
@@ -50,10 +69,23 @@ public IFeatureCollection ServerFeatures
             }
         }
 
+        /// <summary>
+        /// Gets the current application properties. Not used in the actual testing.
+        /// </summary>
+        /// <value>Result of <see cref="IFeatureCollection"/> type.</value>
         public IDictionary<string, object> Properties { get; }
 
+        /// <summary>
+        /// Gets the registered route collection.
+        /// </summary>
+        /// <value>Result of <see cref="RouteCollection"/> type.</value>
         public RouteCollection Routes { get; set; }
 
+        /// <summary>
+        /// Extracts registered routes from the provided middleware, if such are found.
+        /// </summary>
+        /// <param name="middleware">Middleware delegate.</param>
+        /// <returns>The same <see cref="IApplicationBuilder"/>.</returns>
         public IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware)
         {
             this.ExtractRoutes(middleware);
@@ -62,11 +94,19 @@ public IApplicationBuilder Use(Func<RequestDelegate, RequestDelegate> middleware
             return this;
         }
 
+        /// <summary>
+        /// Returns new instance of <see cref="IApplicationBuilder"/>. Not used in the actual testing.
+        /// </summary>
+        /// <returns>Result of <see cref="IApplicationBuilder"/> type.</returns>
         public IApplicationBuilder New()
         {
             return new MockedApplicationBuilder(this);
         }
 
+        /// <summary>
+        /// Builds the application delegate, which will process the incoming HTTP requests. Not used in the actual testing.
+        /// </summary>
+        /// <returns>Result of <see cref="RequestDelegate"/> type.</returns>
         public RequestDelegate Build()
         {
             RequestDelegate app = context =>

src/MyTested.Mvc/Internal/Application/TestApplication.cs

@@ -31,7 +31,7 @@
     using Microsoft.Extensions.PlatformAbstractions;
     using Routes;
     using Utilities.Extensions;
-
+    
     public static class TestApplication
     {
         private static readonly RequestDelegate NullHandler = (c) => TaskCache.CompletedTask;