feat: fix return type spacing and add rich xml docs for properties, exceptions, types, and parameters (#27)

Author: TimothyMakkison

docs/sample/myclasslib.myclass.md

@@ -42,7 +42,7 @@ public string MyProperty { get; protected set; }
 #### Property Value
 
 [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
-The property value.
+The property value. Used by [MyClass.DoGeneric&lt;T&gt;(T)](./myclasslib.myclass#dogenerictt).
 
 #### Example
 
@@ -126,6 +126,34 @@ The second param.
 [Exception](https://docs.microsoft.com/en-us/dotnet/api/system.exception)<br>
 Thrown when...
 
+### **DoGeneric&lt;T&gt;(T)**
+
+Do some thing.
+
+```csharp
+public int DoGeneric<T>(T value)
+```
+
+#### Type Parameters
+
+`T`<br>
+The type argument. Used by [MyClass.DoGeneric&lt;T&gt;(T)](./myclasslib.myclass#dogenerictt).
+
+#### Parameters
+
+`value` T<br>
+The param. Used by [MyClass.DoGeneric&lt;T&gt;(T)](./myclasslib.myclass#dogenerictt).
+
+#### Returns
+
+[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)<br>
+Returns a value [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32).
+
+#### Exceptions
+
+[ArgumentException](https://docs.microsoft.com/en-us/dotnet/api/system.argumentexception)<br>
+Thrown instead of [Exception](https://docs.microsoft.com/en-us/dotnet/api/system.exception).
+
 ### **Get(List&lt;String&gt;)**
 
 Gets some thing.

docs/sample/myclasslib.subnamespace.subclass.md

@@ -38,7 +38,7 @@ public string MyProperty { get; protected set; }
 #### Property Value
 
 [String](https://docs.microsoft.com/en-us/dotnet/api/system.string)<br>
-The property value.
+The property value. Used by [MyClass.DoGeneric&lt;T&gt;(T)](./myclasslib.myclass#dogenerictt).
 
 #### Example
 

sample/MyClassLib/MyClass.cs

@@ -17,7 +17,7 @@ public class MyClass : IMyInterface
         /// <summary>
         /// My property.
         /// </summary>
-        /// <value>The property value.</value>
+        /// <value>The property value. Used by <see cref="DoGeneric{T}(T)"/>.</value>
         public string MyProperty { get; protected set; }
 
         /// <summary>
@@ -79,6 +79,15 @@ public MyClass(string firstParam, int secondParam) { }
         /// <exception cref="System.Exception">Thrown when...</exception>
         public void Do(string firstParam, int secondParam) { }
 
+        /// <summary>
+        /// Do some thing.
+        /// </summary>
+        /// <typeparam name="T">The type argument. Used by <see cref="DoGeneric{T}(T)"/>.</typeparam>
+        /// <param name="value">The param. Used by <see cref="DoGeneric{T}(T)"/>.</param>
+        /// <returns>Returns a value <see cref="int"/>.</returns>
+        /// <exception cref="ArgumentException">Thrown instead of <see cref="Exception"/>.</exception>
+        public int DoGeneric<T>(T value) { throw new ArgumentException(); }
+
         /// <summary>
         /// Gets some thing.
         /// </summary>

src/XMLDoc2Markdown/Program.cs

@@ -82,7 +82,6 @@ static int Main(string[] args)
 
             string assemblyName = assembly.GetName().Name;
             XmlDocumentation documentation = new(src);
-
             Logger.Info($"Generation started: Assembly: {assemblyName}");
 
             IMarkdownDocument indexPage = new MarkdownDocument().AppendHeader(assemblyName, 1);