Added documentation summary to the HTTP request test builder

Author: ivaylokenov

src/MyTested.Mvc/Builders/Authentication/BaseUserBuilder.cs

@@ -146,7 +146,7 @@ protected void AddClaim(Claim claim)
         /// <summary>
         /// Adds claims to the built <see cref="ClaimsIdentity"/>.
         /// </summary>
-        /// <param name="claims">Enumerable of <see cref="Claim"/> to add.</param>
+        /// <param name="claims">Collection of <see cref="Claim"/> to add.</param>
         protected void AddClaims(IEnumerable<Claim> claims)
         {
             claims.ForEach(c => this.AddClaim(c));
@@ -173,7 +173,7 @@ protected void AddRole(string role)
         /// <summary>
         /// Adds roles to the built <see cref="ClaimsIdentity"/>.
         /// </summary>
-        /// <param name="roles">Enumerable of roles to add.</param>
+        /// <param name="roles">Collection of roles to add.</param>
         protected void AddRoles(IEnumerable<string> roles)
         {
             roles.ForEach(r => this.AddRole(r));

src/MyTested.Mvc/Builders/Base/BaseTestBuilderWithResponseModel.cs

@@ -137,7 +137,7 @@ protected void ValidateContainingOfContentType(MediaTypeHeaderValue contentType)
         /// <summary>
         /// Tests whether action result contains the same content types as the provided ones.
         /// </summary>
-        /// <param name="contentTypes">Expected content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Expected content types as collection of strings.</param>
         protected void ValidateContentTypes(IEnumerable<string> contentTypes)
         {
             this.ValidateContentTypes(contentTypes.Select(ct => new MediaTypeHeaderValue(ct)));
@@ -155,7 +155,7 @@ protected void ValidateContentTypes(params string[] contentTypes)
         /// <summary>
         /// Tests whether action result contains the same content types as the provided ones.
         /// </summary>
-        /// <param name="contentTypes">Expected content types as enumerable of <see cref="MediaTypeHeaderValue"/>.</param>
+        /// <param name="contentTypes">Expected content types as collection of <see cref="MediaTypeHeaderValue"/>.</param>
         protected void ValidateContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes)
         {
             ContentTypeValidator.ValidateContentTypes(
@@ -200,7 +200,7 @@ protected void ValidateContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether action result contains the same output formatters as the provided ones.
         /// </summary>
-        /// <param name="outputFormatters">Expected enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Expected collection of <see cref="IOutputFormatter"/>.</param>
         protected void ValidateOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters)
         {
             OutputFormatterValidator.ValidateOutputFormatters(

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

@@ -97,9 +97,9 @@ public interface IBadRequestTestBuilder : IBaseTestBuilderWithActionResult<Actio
         IAndBadRequestTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether <see cref="BadRequestObjectResult"/> contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="BadRequestObjectResult"/> contains the same content types provided as collection of strings.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Content types as collection of strings.</param>
         /// <returns>The same <see cref="IAndBadRequestTestBuilder"/>.</returns>
         IAndBadRequestTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
@@ -111,9 +111,9 @@ public interface IBadRequestTestBuilder : IBaseTestBuilderWithActionResult<Actio
         IAndBadRequestTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether <see cref="BadRequestObjectResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
+        /// Tests whether <see cref="BadRequestObjectResult"/> contains the same content types provided as collection of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of <see cref="MediaTypeHeaderValue"/>.</param>
+        /// <param name="contentTypes">Content types as collection of <see cref="MediaTypeHeaderValue"/>.</param>
         /// <returns>The same <see cref="IAndBadRequestTestBuilder"/>.</returns>
         IAndBadRequestTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
@@ -142,7 +142,7 @@ IAndBadRequestTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether <see cref="BadRequestObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Collection of <see cref="IOutputFormatter"/>.</param>
         /// <returns>The same <see cref="IAndBadRequestTestBuilder"/>.</returns>
         IAndBadRequestTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);
 

src/MyTested.Mvc/Builders/Contracts/ActionResults/Challenge/IChallengeTestBuilder.cs

@@ -20,9 +20,9 @@ public interface IChallengeTestBuilder : IBaseTestBuilderWithActionResult<Challe
         IAndChallengeTestBuilder ContainingAuthenticationScheme(string authenticationScheme);
 
         /// <summary>
-        /// Tests whether <see cref="ChallengeResult"/> has the provided enumerable of authentication schemes.
+        /// Tests whether <see cref="ChallengeResult"/> has the provided collection of authentication schemes.
         /// </summary>
-        /// <param name="authenticationSchemes">Expected authentication schemes as enumerable.</param>
+        /// <param name="authenticationSchemes">Expected authentication schemes as collection.</param>
         /// <returns>The same <see cref="IAndChallengeTestBuilder"/>.</returns>
         IAndChallengeTestBuilder ContainingAuthenticationSchemes(IEnumerable<string> authenticationSchemes);
 

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

@@ -187,9 +187,9 @@ IAndCreatedTestBuilder At<TController>(Expression<Func<TController, Task>> actio
         IAndCreatedTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether <see cref="CreatedResult"/>, <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="CreatedResult"/>, <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> contains the same content types provided as collection of strings.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Content types as collection of strings.</param>
         /// <returns>The same <see cref="IAndCreatedTestBuilder"/>.</returns>
         IAndCreatedTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
@@ -201,9 +201,9 @@ IAndCreatedTestBuilder At<TController>(Expression<Func<TController, Task>> actio
         IAndCreatedTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether <see cref="CreatedResult"/>, <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
+        /// Tests whether <see cref="CreatedResult"/>, <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> contains the same content types provided as collection of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of <see cref="MediaTypeHeaderValue"/>.</param>
+        /// <param name="contentTypes">Content types as collection of <see cref="MediaTypeHeaderValue"/>.</param>
         /// <returns>The same <see cref="IAndCreatedTestBuilder"/>.</returns>
         IAndCreatedTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
@@ -232,7 +232,7 @@ IAndCreatedTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether <see cref="CreatedResult"/>, <see cref="CreatedAtActionResult"/> or <see cref="CreatedAtRouteResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Collection of <see cref="IOutputFormatter"/>.</param>
         /// <returns>The same <see cref="IAndCreatedTestBuilder"/>.</returns>
         IAndCreatedTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);
 

src/MyTested.Mvc/Builders/Contracts/ActionResults/Forbid/IForbidTestBuilder.cs

@@ -20,9 +20,9 @@ public interface IForbidTestBuilder : IBaseTestBuilderWithActionResult<ForbidRes
         IAndForbidTestBuilder ContainingAuthenticationScheme(string authenticationScheme);
 
         /// <summary>
-        /// Tests whether <see cref="ForbidResult"/> has the provided enumerable of authentication schemes.
+        /// Tests whether <see cref="ForbidResult"/> has the provided collection of authentication schemes.
         /// </summary>
-        /// <param name="authenticationSchemes">Expected authentication schemes as enumerable.</param>
+        /// <param name="authenticationSchemes">Expected authentication schemes as collection.</param>
         /// <returns>The same <see cref="IAndForbidTestBuilder"/>.</returns>
         IAndForbidTestBuilder ContainingAuthenticationSchemes(IEnumerable<string> authenticationSchemes);
 

src/MyTested.Mvc/Builders/Contracts/ActionResults/Json/IJsonSerializerSettingsTestBuilder.cs

@@ -67,7 +67,7 @@ IAndJsonSerializerSettingsTestBuilder ContainingConverterOfType<TJsonConverter>(
         /// <summary>
         /// Tests whether the <see cref="JsonSerializerSettings"/> contains the provided <see cref="JsonConverter"/> objects.
         /// </summary>
-        /// <param name="jsonConverters">Enumerable of <see cref="JsonConverter"/>.</param>
+        /// <param name="jsonConverters">Collection of <see cref="JsonConverter"/>.</param>
         /// <returns>The same <see cref="IAndJsonSerializerSettingsTestBuilder"/>.</returns>
         IAndJsonSerializerSettingsTestBuilder ContainingConverters(IEnumerable<JsonConverter> jsonConverters);
 

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

@@ -48,9 +48,9 @@ public interface INotFoundTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndNotFoundTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as collection of strings.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Content types as collection of strings.</param>
         /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
@@ -62,9 +62,9 @@ public interface INotFoundTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndNotFoundTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
+        /// Tests whether <see cref="NotFoundObjectResult"/> contains the same content types provided as collection of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of MediaTypeHeaderValue.</param>
+        /// <param name="contentTypes">Content types as collection of MediaTypeHeaderValue.</param>
         /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
@@ -93,7 +93,7 @@ IAndNotFoundTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether <see cref="NotFoundObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Collection of <see cref="IOutputFormatter"/>.</param>
         /// <returns>The same <see cref="IAndNotFoundTestBuilder"/>.</returns>
         IAndNotFoundTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);
 

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

@@ -42,9 +42,9 @@ public interface IObjectTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndObjectTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether <see cref="ObjectResult"/> contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="ObjectResult"/> contains the same content types provided as collection of strings.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Content types as collection of strings.</param>
         /// <returns>The same <see cref="IAndObjectTestBuilder"/>.</returns>
         IAndObjectTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
@@ -56,9 +56,9 @@ public interface IObjectTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndObjectTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether <see cref="ObjectResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
+        /// Tests whether <see cref="ObjectResult"/> contains the same content types provided as collection of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of MediaTypeHeaderValue.</param>
+        /// <param name="contentTypes">Content types as collection of MediaTypeHeaderValue.</param>
         /// <returns>The same <see cref="IAndObjectTestBuilder"/>.</returns>
         IAndObjectTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
@@ -87,7 +87,7 @@ IAndObjectTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether <see cref="ObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Collection of <see cref="IOutputFormatter"/>.</param>
         /// <returns>The same <see cref="IAndObjectTestBuilder"/>.</returns>
         IAndObjectTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);
 

src/MyTested.Mvc/Builders/Contracts/ActionResults/Ok/IOkTestBuilder.cs

@@ -48,9 +48,9 @@ public interface IOkTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndOkTestBuilder ContainingContentType(MediaTypeHeaderValue contentType);
 
         /// <summary>
-        /// Tests whether <see cref="OkObjectResult"/> contains the same content types provided as enumerable of strings.
+        /// Tests whether <see cref="OkObjectResult"/> contains the same content types provided as collection of strings.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of strings.</param>
+        /// <param name="contentTypes">Content types as collection of strings.</param>
         /// <returns>The same <see cref="IAndOkTestBuilder"/>.</returns>
         IAndOkTestBuilder ContainingContentTypes(IEnumerable<string> contentTypes);
 
@@ -62,9 +62,9 @@ public interface IOkTestBuilder : IBaseTestBuilderWithResponseModel,
         IAndOkTestBuilder ContainingContentTypes(params string[] contentTypes);
 
         /// <summary>
-        /// Tests whether <see cref="OkObjectResult"/> contains the same content types provided as enumerable of <see cref="MediaTypeHeaderValue"/>.
+        /// Tests whether <see cref="OkObjectResult"/> contains the same content types provided as collection of <see cref="MediaTypeHeaderValue"/>.
         /// </summary>
-        /// <param name="contentTypes">Content types as enumerable of <see cref="MediaTypeHeaderValue"/>.</param>
+        /// <param name="contentTypes">Content types as collection of <see cref="MediaTypeHeaderValue"/>.</param>
         /// <returns>The same <see cref="IAndOkTestBuilder"/>.</returns>
         IAndOkTestBuilder ContainingContentTypes(IEnumerable<MediaTypeHeaderValue> contentTypes);
 
@@ -93,7 +93,7 @@ IAndOkTestBuilder ContainingOutputFormatterOfType<TOutputFormatter>()
         /// <summary>
         /// Tests whether <see cref="OkObjectResult"/> contains the provided output formatters.
         /// </summary>
-        /// <param name="outputFormatters">Enumerable of <see cref="IOutputFormatter"/>.</param>
+        /// <param name="outputFormatters">Collection of <see cref="IOutputFormatter"/>.</param>
         /// <returns>The same <see cref="IAndOkTestBuilder"/>.</returns>
         IAndOkTestBuilder ContainingOutputFormatters(IEnumerable<IOutputFormatter> outputFormatters);