adding the dotnet-cstomd to DryIoc.Docs project and md generation in debug; fixing the collapsible sections

Author: maximv

docs/DryIoc.Docs/.config/dotnet-tools.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "dotnet-cstomd": {
+      "version": "1.2.0",
+      "commands": [
+        "cstomd"
+      ]
+    }
+  }
+}

docs/DryIoc.Docs/DryIoc.Docs.csproj

@@ -23,6 +23,16 @@
         <ProjectReference Include="..\..\src\DryIoc.MefAttributedModel\DryIoc.MefAttributedModel.csproj" />
     </ItemGroup>
 
+    <ItemGroup>
+        <DocFile Include="**\*.cs" />
+    </ItemGroup>
+
+    <Target Name="MdGenerate" BeforeTargets="BeforeBuild"
+        Condition=" '$(Configuration)' == 'Debug' ">
+        <Message Text="Generating the Markdown documentation..." Importance="high"/>
+        <Exec WorkingDirectory="$(ProjectDir)" Command="dotnet cstomd %(DocFile.Identity)" />
+    </Target>
+
     <ItemGroup>
       <Compile Update="Extensions\MefAttributedModel.cs">
         <Generator>CsToMd</Generator>

docs/DryIoc.Docs/SelectConstructorOrFactoryMethod.cs

@@ -26,16 +26,19 @@ Default constructor means no dependencies.
 To avoid the exception you may specify what constructor to use while registering.
 
 Given the class with the two constructors:
-```cs md*/
+md*/
 //md{ usings ...
+//md```cs
 using DryIoc;
 using DryIocAttributes;
 using DryIoc.MefAttributedModel;
 using System.ComponentModel.Composition;
 using NUnit.Framework;
 // ReSharper disable UnusedVariable
+//md```
 //md}
 
+//md```cs
 public interface IDependency { }
 public class Dep : IDependency {}
 public class Foo 

docs/DryIoc.Docs/SelectConstructorOrFactoryMethod.md

@@ -25,14 +25,19 @@ If class has multiple constructors the default behavior is to throw correspondin
 To avoid the exception you may specify what constructor to use while registering.
 
 Given the class with the two constructors:
-```cs 
+<details><summary><strong>usings ...</strong></summary>
+
+```cs
 using DryIoc;
 using DryIocAttributes;
 using DryIoc.MefAttributedModel;
 using System.ComponentModel.Composition;
 using NUnit.Framework;
 // ReSharper disable UnusedVariable
+```
+</details>
 
+```cs
 public interface IDependency { }
 public class Dep : IDependency {}
 public class Foo 

docs/DryIoc.Docs/SpecifyDependencyAndPrimitiveValues.cs

@@ -24,15 +24,17 @@
 ## Service Type
 
 The minimal part of service and dependency resolution specification is Service Type. It allows container to find corresponding service registration:
-
-```cs md*/
+md*/
 //md{ usings ...
+//md```cs
 using System;
 using NUnit.Framework;
 using DryIoc;
 // ReSharper disable UnusedVariable
+//md```
 //md}
 
+//md```cs 
 class Resolving_with_a_service_type 
 {
     [Test] public void Example()

docs/DryIoc.Docs/SpecifyDependencyAndPrimitiveValues.md

@@ -23,15 +23,17 @@
 ## Service Type
 
 The minimal part of service and dependency resolution specification is Service Type. It allows container to find corresponding service registration:
+<details><summary><strong>usings ...</strong></summary>
 
-```cs 
-//md{ usings ...
+```cs
 using System;
 using NUnit.Framework;
 using DryIoc;
 // ReSharper disable UnusedVariable
-//md}
+```
+</details>
 
+```cs 
 class Resolving_with_a_service_type 
 {
     [Test] public void Example()
@@ -397,7 +399,7 @@ class Injecting_the_custom_value_depending_on_context
 
     public interface ILogger
     {
-        public Type ContextType { get; }
+        Type ContextType { get; }
     }
 
     public class Logger : ILogger 

docs/DryIoc.Docs/ThreadSafety.cs

@@ -20,8 +20,9 @@
 
 The above guaranties are possible because of the Container data-structure. 
 In a pseudo code and simplifying things a lot the DryIoc Container may be represented as following:
-```cs md*/
+md*/
 //md{ usings ...
+//md```cs 
 using System;
 using System.Linq.Expressions;
 using System.Threading.Tasks;
@@ -30,8 +31,10 @@ The above guaranties are possible because of the Container data-structure.
 using DryIoc;
 #pragma warning disable CS0649
 // ReSharper disable UnusedVariable
+//md```
 //md}
 
+//md```cs 
 class Oversimplified_container 
 {
     class Ref<T> { public T Value; } // represents the CAS (compare-and-swap) box for the referenced value

docs/DryIoc.Docs/ThreadSafety.md

@@ -19,8 +19,9 @@ DryIoc ensures that:
 
 The above guaranties are possible because of the Container data-structure. 
 In a pseudo code and simplifying things a lot the DryIoc Container may be represented as following:
+<details><summary><strong>usings ...</strong></summary>
+
 ```cs 
-//md{ usings ...
 using System;
 using System.Linq.Expressions;
 using System.Threading.Tasks;
@@ -29,8 +30,10 @@ using ImTools;
 using DryIoc;
 #pragma warning disable CS0649
 // ReSharper disable UnusedVariable
-//md}
+```
+</details>
 
+```cs 
 class Oversimplified_container 
 {
     class Ref<T> { public T Value; } // represents the CAS (compare-and-swap) box for the referenced value

docs/DryIoc.Docs/UsingInTestsWithMockingLibrary.md

@@ -10,15 +10,16 @@
 
 For examples below we need to add:
 
-//md{ usings ...
-//md ```cs
+<details><summary><strong>usings ...</strong></summary>
+
+ ```cs
 using System.Collections.Concurrent;
 using NUnit.Framework;
 using DryIoc;
 using NSubstitute;
 using Moq;
-//md ```
-//md}
+ ```
+</details>
 
 
 ## Auto-mocking with NSubstitute