Added documentation summary for all action result test builders

Author: ivaylokenov

src/MyTested.Mvc/Builders/Contracts/ActionResults/BadRequest/IBadRequestTestBuilder.cs

@@ -69,14 +69,14 @@ public interface IBadRequestTestBuilder : IBaseTestBuilderWithActionResult<Actio
         IModelErrorTestBuilder<TRequestModel> WithModelStateErrorFor<TRequestModel>();
 
         /// <summary>
-        /// Tests whether <see cref="BadRequestResult"/> or <see cref="BadRequestObjectResult"/> has the same status code as the provided one.
+        /// Tests whether <see cref="BadRequestObjectResult"/> has the same status code as the provided one.
         /// </summary>
         /// <param name="statusCode">Status code as integer.</param>
         /// <returns>The same <see cref="IAndBadRequestTestBuilder"/>.</returns>
         IAndBadRequestTestBuilder WithStatusCode(int statusCode);
 
         /// <summary>
-        /// Tests whether <see cref="BadRequestResult"/> or <see cref="BadRequestObjectResult"/> has the same status code as the provided <see cref="HttpStatusCode"/>.
+        /// Tests whether <see cref="BadRequestObjectResult"/> has the same status code as the provided <see cref="HttpStatusCode"/>.
         /// </summary>
         /// <param name="statusCode"><see cref="HttpStatusCode"/> enumeration.</param>
         /// <returns>The same <see cref="IAndBadRequestTestBuilder"/>.</returns>

src/MyTested.Mvc/Builders/Contracts/ActionResults/Created/ICreatedTestBuilder.cs

@@ -153,7 +153,7 @@ IAndCreatedTestBuilder At<TController>(Expression<Action<TController>> actionCal
         /// Tests whether <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> returns created at specific asynchronous action.
         /// </summary>
         /// <typeparam name="TController">Type of expected controller.</typeparam>
-        /// <param name="actionCall">Method call expression indicating the expected asynchronous action.</param>
+        /// <param name="actionCall">Method call expression indicating the expected asynchronous created action.</param>
         /// <returns>The same <see cref="IAndCreatedTestBuilder"/>.</returns>
         IAndCreatedTestBuilder At<TController>(Expression<Func<TController, Task>> actionCall)
             where TController : class;

src/MyTested.Mvc/Builders/Contracts/ActionResults/LocalRedirect/IAndLocalRedirectTestBuilder.cs

@@ -1,14 +1,14 @@
 namespace MyTested.Mvc.Builders.Contracts.ActionResults.LocalRedirect
 {
     /// <summary>
-    /// Used for adding AndAlso() method to the the local redirect response tests.
+    /// Used for adding AndAlso() method to the <see cref="Microsoft.AspNetCore.Mvc.LocalRedirectResult"/> tests.
     /// </summary>
     public interface IAndLocalRedirectTestBuilder : ILocalRedirectTestBuilder
     {
         /// <summary>
-        /// AndAlso method for better readability when chaining local redirect result tests.
+        /// AndAlso method for better readability when chaining <see cref="Microsoft.AspNetCore.Mvc.LocalRedirectResult"/> tests.
         /// </summary>
-        /// <returns>Local redirect result test builder.</returns>
+        /// <returns>The same <see cref="ILocalRedirectTestBuilder"/>.</returns>
         ILocalRedirectTestBuilder AndAlso();
     }
 }

src/MyTested.Mvc/Builders/Contracts/ActionResults/LocalRedirect/ILocalRedirectTestBuilder.cs

@@ -8,75 +8,81 @@
     using Uris;
 
     /// <summary>
-    /// Used for testing local redirect result.
+    /// Used for testing <see cref="LocalRedirectResult"/>.
     /// </summary>
     public interface ILocalRedirectTestBuilder : IBaseTestBuilderWithActionResult<LocalRedirectResult>
     {
         /// <summary>
-        /// Tests whether local redirect result is permanent.
+        /// Tests whether <see cref="LocalRedirectResult"/> is permanent.
         /// </summary>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder Permanent();
 
         /// <summary>
-        /// Tests whether local redirect result has specific URL provided as string.
+        /// Tests whether <see cref="LocalRedirectResult"/> has specific URL provided as string.
         /// </summary>
         /// <param name="localUrl">Expected URL as string.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder ToUrl(string localUrl);
 
         /// <summary>
-        /// Tests whether local redirect result URL passes given assertions.
+        /// Tests whether <see cref="LocalRedirectResult"/> URL passes given assertions.
         /// </summary>
         /// <param name="assertions">Action containing all assertions on the URL.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder ToUrlPassing(Action<string> assertions);
 
         /// <summary>
-        /// Tests whether local redirect result URL passes given predicate.
+        /// Tests whether <see cref="LocalRedirectResult"/> URL passes given predicate.
         /// </summary>
         /// <param name="predicate">Predicate testing the URL.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder ToUrlPassing(Func<string, bool> predicate);
 
         /// <summary>
-        /// Tests whether local redirect result has specific URL provided as URI.
+        /// Tests whether <see cref="LocalRedirectResult"/> has specific URL provided as <see cref="Uri"/>.
         /// </summary>
-        /// <param name="localUrl">Expected URL as URI.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <param name="localUrl">Expected URL as <see cref="Uri"/>.</param>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder ToUrl(Uri localUrl);
 
         /// <summary>
-        /// Tests whether local redirect result has specific location provided by builder.
+        /// Tests whether <see cref="LocalRedirectResult"/> has specific location provided by builder.
         /// </summary>
-        /// <param name="uriTestBuilder">Builder for expected URI.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <param name="uriTestBuilder">Builder for expected URL.</param>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder ToUrl(Action<IUriTestBuilder> uriTestBuilder);
 
         /// <summary>
-        /// Tests whether local redirect result has the same URL helper as the provided one.
+        /// Tests whether <see cref="LocalRedirectResult"/> has the same <see cref="IUrlHelper"/> as the provided one.
         /// </summary>
-        /// <param name="urlHelper">URL helper of type IUrlHelper.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <param name="urlHelper">URL helper of type <see cref="IUrlHelper"/>.</param>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder WithUrlHelper(IUrlHelper urlHelper);
 
         /// <summary>
-        /// Tests whether local redirect result has the same URL helper type as the provided one.
+        /// Tests whether <see cref="LocalRedirectResult"/> has the same <see cref="IUrlHelper"/> type as the provided one.
         /// </summary>
-        /// <typeparam name="TUrlHelper">URL helper of type IUrlHelper.</typeparam>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <typeparam name="TUrlHelper">URL helper of type <see cref="IUrlHelper"/>.</typeparam>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder WithUrlHelperOfType<TUrlHelper>()
             where TUrlHelper : IUrlHelper;
 
         /// <summary>
-        /// Tests whether local redirect result redirects to specific action.
+        /// Tests whether <see cref="LocalRedirectResult"/> redirects to specific action.
         /// </summary>
         /// <typeparam name="TController">Type of expected redirect controller.</typeparam>
         /// <param name="actionCall">Method call expression indicating the expected redirect action.</param>
-        /// <returns>The same local redirect test builder.</returns>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder To<TController>(Expression<Action<TController>> actionCall)
             where TController : class;
 
+        /// <summary>
+        /// Tests whether <see cref="LocalRedirectResult"/> redirects to specific asynchronous action.
+        /// </summary>
+        /// <typeparam name="TController">Type of expected redirect controller.</typeparam>
+        /// <param name="actionCall">Method call expression indicating the expected asynchronous action.</param>
+        /// <returns>The same <see cref="IAndLocalRedirectTestBuilder"/>.</returns>
         IAndLocalRedirectTestBuilder To<TController>(Expression<Func<TController, Task>> actionCall)
             where TController : class;
     }

src/MyTested.Mvc/Builders/Contracts/ActionResults/NotFound/IAndNotFoundTestBuilder.cs

@@ -1,14 +1,14 @@
 namespace MyTested.Mvc.Builders.Contracts.ActionResults.NotFound
 {
     /// <summary>
-    /// Used for adding AndAlso() method to the HTTP not found response tests.
+    /// Used for adding AndAlso() method to the <see cref="Microsoft.AspNetCore.Mvc.NotFoundResult"/> or <see cref="Microsoft.AspNetCore.Mvc.NotFoundObjectResult"/> tests.
     /// </summary>
     public interface IAndNotFoundTestBuilder : INotFoundTestBuilder
     {
         /// <summary>
-        /// AndAlso method for better readability when chaining HTTP not found result tests.
+        /// AndAlso method for better readability when chaining <see cref="Microsoft.AspNetCore.Mvc.NotFoundResult"/> or <see cref="Microsoft.AspNetCore.Mvc.NotFoundObjectResult"/> tests.
         /// </summary>
-        /// <returns>HTTP not found result test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder AndAlso();
     }
 }

src/MyTested.Mvc/Builders/Contracts/ActionResults/NotFound/INotFoundTestBuilder.cs

@@ -8,100 +8,100 @@
     using Microsoft.Net.Http.Headers;
 
     /// <summary>
-    /// Used for testing HTTP not found result.
+    /// Used for testing <see cref="NotFoundResult"/> or <see cref="NotFoundObjectResult"/>.
     /// </summary>
     public interface INotFoundTestBuilder : IBaseTestBuilderWithResponseModel,
         IBaseTestBuilderWithActionResult<ActionResult>
     {
         /// <summary>
         /// Tests whether no response model is returned from the invoked action.
         /// </summary>
-        /// <returns>Base test builder with action.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder WithNoResponseModel();
 
         /// <summary>
-        /// Tests whether HTTP not found result has the same status code as the provided one.
+        /// Tests whether <see cref="NotFoundObjectResult"/> has the same status code as the provided one.
         /// </summary>
-        /// <param name="statusCode">Status code.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="statusCode">Status code as integer.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder WithStatusCode(int statusCode);
 
         /// <summary>
-        /// Tests whether HTTP not found has the same status code as the provided HttpStatusCode.
+        /// Tests whether <see cref="NotFoundObjectResult"/> has the same status code as the provided <see cref="HttpStatusCode"/>.
         /// </summary>
-        /// <param name="statusCode">HttpStatusCode enumeration.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="statusCode"><see cref="HttpStatusCode"/> enumeration.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder WithStatusCode(HttpStatusCode statusCode);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the content type provided as string.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the content type provided as string.
         /// </summary>
         /// <param name="contentType">Content type as string.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentType(string contentType);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the content type provided as MediaTypeHeaderValue.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the content type provided as <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentType">Content type as MediaTypeHeaderValue.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="contentType">Content type as <see cref="MediaTypeHeaderValue"/>.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as enumerable of strings.
         /// </summary>
         /// <param name="contentTypes">Content types as enumerable of strings.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the same content types provided as string parameters.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as string parameters.
         /// </summary>
         /// <param name="contentTypes">Content types as string parameters.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the same content types provided as enumerable of MediaTypeHeaderValue.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
         /// <param name="contentTypes">Content types as enumerable of MediaTypeHeaderValue.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the same content types provided as MediaTypeHeaderValue parameters.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as <see cref="MediaTypeHeaderValue"/> parameters.
         /// </summary>
         /// <param name="contentTypes">Content types as MediaTypeHeaderValue parameters.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(params MediaTypeHeaderValue[] contentTypes);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the provided output formatter.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the provided <see cref="IOutputFormatter"/>.
         /// </summary>
-        /// <param name="outputFormatter">Instance of IOutputFormatter.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="outputFormatter">Instance of <see cref="IOutputFormatter"/>.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingOutputFormatter(IOutputFormatter outputFormatter);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains output formatter of the provided type.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains <see cref="IOutputFormatter"/> of the provided type.
         /// </summary>
-        /// <typeparam name="TOutputFormatter">Type of IOutputFormatter.</typeparam>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <typeparam name="TOutputFormatter">Type of <see cref="IOutputFormatter"/>.</typeparam>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
             where TOutputFormatter : IOutputFormatter;
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the provided output formatters.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of IOutputFormatter.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);
 
         /// <summary>
-        /// Tests whether HTTP not found result contains the provided output formatters.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Output formatter parameters.</param>
-        /// <returns>The same HTTP not found test builder.</returns>
+        /// <param name="outputFormatters"><see cref="IOutputFormatter"/> parameters.</param>
+        /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingOutputFormatters(params IOutputFormatter[] outputFormatters);
     }
 }

src/MyTested.Mvc/Builders/Contracts/ActionResults/Object/IAndObjectTestBuilder.cs

@@ -1,7 +1,14 @@
 namespace MyTested.Mvc.Builders.Contracts.ActionResults.Object
 {
+    /// <summary>
+    /// Used for adding AndAlso() method to the <see cref="Microsoft.AspNetCore.Mvc.ObjectResult"/> tests.
+    /// </summary>
     public interface IAndObjectTestBuilder : IObjectTestBuilder
     {
+        /// <summary>
+        /// AndAlso method for better readability when chaining <see cref="Microsoft.AspNetCore.Mvc.ObjectResult"/> tests.
+        /// </summary>
+        /// <returns>The same <see cref="IObjectTestBuilder"/>.</returns>
         IObjectTestBuilder AndAlso();
     }
 }