Support override files for docs

Author: TheBoxyBear

ChartTools/ChartTools.Generator/MetadataMapGenerator.cs

@@ -11,9 +11,7 @@
 
 namespace ChartTools.Generator;
 
-/// <summary>
-/// Generates mapping methods between <see cref="Metadata"/> properties and their corresponding keys in different file formats, as defined by <see cref="MetadataKeyAttribute"/>
-/// </summary>
+/// <exclude />
 [Generator]
 public class MetadataMapGenerator : IIncrementalGenerator
 {

ChartTools/Docs/apidocs/README.txt

@@ -0,0 +1,3 @@
+Use this directory to override sections of the Api Documentation with custom markdown instead of referring to the xml tag in the code. Use this to provide code examples and embed partial usage documentation. Include links to relevant Articles.
+
+See https://github.com/dotnet/docfx/blob/main/docs/tutorial/intro_overwrite_files.md

ChartTools/Docs/docfx.json

@@ -10,7 +10,7 @@
         }
       ],
       "dest": "api",
-      "namespaceLayout":  "nested"
+      "namespaceLayout": "nested"
     }
   ],
   "build": {
@@ -21,10 +21,12 @@
         ],
         "exclude": [
           "_site/**",
-          "obj/**"
+          "obj/**",
+          "apidocs/**"
         ]
       }
     ],
+    "overwrite": "apidocs/*.md",
     "resource": [
       {
         "files": [