Updated API documentation (closes #193)

Author: ivaylokenov

docs/_docfx/api/.manifest

@@ -1,9 +1,29 @@
 # Welcome to the API Reference
 
-Here you will find My Tested ASP.NET Core MVC API reference containing detailed information on all publicly available assertion methods and classes.
+Here you will find [My Tested ASP.NET Core MVC](https://mytestedasp.net/Core/Mvc) API reference containing detailed information on all publicly available assertion methods and classes.
 
-Commonly used types:
+<strong class="article-contents">Test case starting points</strong>
 
-- [MyMvc](/api/MyTested.AspNetCore.Mvc.MyMvc.html) - starting point of the framework
-- [IControllerBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.Controllers.IControllerBuilder`1.html) - controller test builder
-- [IRouteTestBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.Routes.IRouteTestBuilder.html) - route test builder
+- [MyMvc](/api/MyTested.AspNetCore.Mvc.MyMvc.html) - contains all available starting points
+- [MyApplication](/api/MyTested.AspNetCore.Mvc.MyApplication.html) - specifies the test application
+- [MyController](/api/MyTested.AspNetCore.Mvc.MyController-1.html) - specifies controller test case
+- [MyViewComponent](/api/MyTested.AspNetCore.Mvc.MyViewComponent-1.html) - specifies view component test case
+- [MyRouting](/api/MyTested.AspNetCore.Mvc.MyRouting.html) - specifies route test case
+
+<strong class="article-contents">Commonly used test builders</strong>
+
+- [IControllerBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.Controllers.IControllerBuilder-1.html) - controller test builder
+- [IViewComponentBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.ViewComponents.IViewComponentBuilder-1.html) - view component test builder
+- [IRouteTestBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.Routes.IRouteTestBuilder.html) - route test builder
+- [IApplicationConfigurationBuilder](/api/MyTested.AspNetCore.Mvc.Builders.Contracts.Application.IApplicationConfigurationBuilder.html) - application configuration builder
+
+<strong class="article-contents">Helper classes</strong>
+
+- [From](/api/MyTested.AspNetCore.Mvc.From.html) - helps with resolving values in lambda expressions
+- [With](/api/MyTested.AspNetCore.Mvc.With.html) - helps with null, default and ignored values
+- [AuthenticationScheme](/api/MyTested.AspNetCore.Mvc.AuthenticationScheme.html) - contains common authentication schemes
+- [ContentType](/api/MyTested.AspNetCore.Mvc.ContentType.html) - contains common content type header values
+- [HttpHeader](/api/MyTested.AspNetCore.Mvc.HttpHeader.html) - contains common HTTP header names
+- [HttpMethod](/api/MyTested.AspNetCore.Mvc.HttpMethod.html) - contains common HTTP methods
+- [HttpScheme](/api/MyTested.AspNetCore.Mvc.HttpScheme.html) - contains common HTTP schemes
+- [HttpStatusCode](/api/MyTested.AspNetCore.Mvc.HttpStatusCode.html) - contains common HTTP status codes

docs/_docfx/api/index.md

@@ -7,7 +7,7 @@ $(function() {
 
 			elements.each(function (i, el) {
 			  $(el).text($(el).text().replace('MyTested.AspNetCore.Mvc.Builders.Contracts.', ''));
-			  $(el).text($(el).text().replace('MyTested.AspNetCore.Mvc', 'Common'));
+			  $(el).text($(el).text().replace('MyTested.AspNetCore.Mvc', 'Common Classes & Extensions'));
 			});
 
 			$('#toc.toc').show();

docs/_docfx/custom/styles/main.js

@@ -13,8 +13,12 @@ apiRules:
     uidRegex: ^MyTested.AspNetCore.Mvc.HttpStatusCode
 - include:
     uidRegex: ^MyTested.AspNetCore.Mvc.With
+- include:
+    uidRegex: ^MyTested.AspNetCore.Mvc.From
 - include:
     uidRegex: ^MyTested.AspNetCore.Mvc.My
+- exclude:
+    uidRegex: ^MyTested.AspNetCore.Mvc.Utilities.Extensions
 - include:
     uidRegex: Extensions$
 - exclude:
@@ -23,5 +27,7 @@ apiRules:
     uidRegex: IAnd
 - exclude:
     uidRegex: ^MyTested.AspNetCore.Mvc.Internal
+- exclude:
+    uidRegex: ^MyTested.AspNetCore.Mvc.Plugins
 - include:
     type: Interface

docs/_docfx/filterConfig.yml

@@ -1,9 +1,7 @@
 # Welcome to the Troubleshoot
 
-Here you will find My Tested ASP.NET Core MVC solutions for frequently asked questions and common problems.
+Here you will find [My Tested ASP.NET Core MVC](https://mytestedasp.net/Core/Mvc) solutions for frequently asked questions and common problems.
 
-<strong class="article-contents">The troubleshoot section is still work in progress...</strong>
+<strong class="article-contents">Table of contents</strong>
 
-<span>Sorry for the inconvenience caused! :(</span>
-
-<img src="/images/catsorry.jpg" />
+- [When I run a test, I receive a type initializer exception without any descriptive message](/troubleshoot/typeinitexception.html)

docs/_docfx/images/troubleshoot/typeinitexception.jpg

@@ -1,3 +1,5 @@
 
 - name: Introduction
-  href: intro.md
+  href: intro.md
+- name: Type Initializer Exception
+  href: typeinitexception.md

docs/_docfx/troubleshoot/intro.md

@@ -0,0 +1,7 @@
+# When I run a test, I receive a type initializer exception without any descriptive message
+
+`MyTested.AspNetCore.Mvc` uses a static constructor to bootstrap and prepare the test application. If your configuration is not valid, `System.TypeInitializerException` may be thrown. Depending on your test runner, you may not see a descriptive and helpful message.
+
+In order to see more details about the problem, run the test in `Debug` mode and analyse the message of the `InnerException`.
+
+<img src="/images/troubleshoot/typeinitexception.jpg" />

docs/_docfx/troubleshoot/toc.yml

@@ -1,6 +1,6 @@
 # Welcome to the Tutorial
 
-Here you will find My Tested ASP.NET Core MVC tutorial, in which you will learn the most important parts of the testing framework.
+Here you will find [My Tested ASP.NET Core MVC](https://mytestedasp.net/Core/Mvc) tutorial, in which you will learn the most important parts of the testing framework.
 
 <strong class="article-contents">The tutorial is still work in progress...</strong>
 

docs/_docfx/troubleshoot/typeinitexception.md

@@ -87,10 +87,10 @@ <h3 id="methods">Methods
               </h3>
               <span class="small pull-right mobile-hide">
                 <span class="divider">|</span>
-                <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/new/development/docs/_docfx/apispec/new?filename=MyTested_AspNetCore_Mvc_ActionAttributesTestBuilderViewFeaturesExtensions_ValidatingAntiForgeryToken_MyTested_AspNetCore_Mvc_Builders_Contracts_Attributes_IActionAttributesTestBuilder_.md&amp;value=---%0Auid%3A%20MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions.ValidatingAntiForgeryToken(MyTested.AspNetCore.Mvc.Builders.Contracts.Attributes.IActionAttributesTestBuilder)%0Asummary%3A%20'*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax'%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
+                <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/new/documentation/docs/_docfx/apispec/new?filename=MyTested_AspNetCore_Mvc_ActionAttributesTestBuilderViewFeaturesExtensions_ValidatingAntiForgeryToken_MyTested_AspNetCore_Mvc_Builders_Contracts_Attributes_IActionAttributesTestBuilder_.md&amp;value=---%0Auid%3A%20MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions.ValidatingAntiForgeryToken(MyTested.AspNetCore.Mvc.Builders.Contracts.Attributes.IActionAttributesTestBuilder)%0Asummary%3A%20'*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax'%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A">Improve this Doc</a>
               </span>
               <span class="small pull-right mobile-hide">
-                <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/blob/development/src/MyTested.AspNetCore.Mvc.ViewFeatures/ActionAttributesTestBuilderViewFeaturesExtensions.cs/#L16">View Source</a>
+                <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/blob/documentation/src/MyTested.AspNetCore.Mvc.ViewFeatures/ActionAttributesTestBuilderViewFeaturesExtensions.cs/#L16">View Source</a>
               </span>
               <h4 id="MyTested_AspNetCore_Mvc_ActionAttributesTestBuilderViewFeaturesExtensions_ValidatingAntiForgeryToken_MyTested_AspNetCore_Mvc_Builders_Contracts_Attributes_IActionAttributesTestBuilder_" data-uid="MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions.ValidatingAntiForgeryToken(MyTested.AspNetCore.Mvc.Builders.Contracts.Attributes.IActionAttributesTestBuilder)">ValidatingAntiForgeryToken(IActionAttributesTestBuilder)</h4>
               <div class="markdown level1 summary"><p sourcefile="api/MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions.yml" sourcestartlinenumber="2" sourceendlinenumber="2">Tests whether the action attributes contain <span class="xref">Microsoft.AspNetCore.Mvc.ValidateAntiForgeryTokenAttribute</span>.</p>
@@ -142,10 +142,10 @@ <h5 class="returns">Returns</h5>
               <div class="contribution">
                 <ul class="nav">
                   <li>
-                    <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/new/development/docs/_docfx/apispec/new?filename=MyTested_AspNetCore_Mvc_ActionAttributesTestBuilderViewFeaturesExtensions.md&amp;value=---%0Auid%3A%20MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions%0Asummary%3A%20'*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax'%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A" class="contribution-link">Improve this Doc</a>
+                    <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/new/documentation/docs/_docfx/apispec/new?filename=MyTested_AspNetCore_Mvc_ActionAttributesTestBuilderViewFeaturesExtensions.md&amp;value=---%0Auid%3A%20MyTested.AspNetCore.Mvc.ActionAttributesTestBuilderViewFeaturesExtensions%0Asummary%3A%20'*You%20can%20override%20summary%20for%20the%20API%20here%20using%20*MARKDOWN*%20syntax'%0A---%0A%0A*Please%20type%20below%20more%20information%20about%20this%20API%3A*%0A%0A" class="contribution-link">Improve this Doc</a>
                   </li>
                   <li>
-                    <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/blob/development/src/MyTested.AspNetCore.Mvc.ViewFeatures/ActionAttributesTestBuilderViewFeaturesExtensions.cs/#L9" class="contribution-link">View Source</a>
+                    <a href="https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/blob/documentation/src/MyTested.AspNetCore.Mvc.ViewFeatures/ActionAttributesTestBuilderViewFeaturesExtensions.cs/#L9" class="contribution-link">View Source</a>
                   </li>
                 </ul>
               </div>