docfx improvement (open-telemetry#922)

Co-authored-by: Cijo Thomas <[email protected]>

Author: reyang

.gitignore

@@ -25,6 +25,10 @@ bld/
 [Oo]bj/
 [Ll]og/
 
+# DocFx output
+_api/
+_site/
+
 # Visual Studio 2015/2017 cache/options directory
 .vs/
 # Uncomment if you have tasks that create the project's static files in wwwroot

build/docfx.cmd

@@ -3,7 +3,10 @@ SETLOCAL ENABLEEXTENSIONS
 
 type docs\docfx.json > docfx.json
 type docs\toc.yml > toc.yml
+docfx metadata
 docfx build docfx.json > docfx.log
+DEL docfx.json 2> NUL
+DEL toc.yml 2> NUL
 @IF NOT %ERRORLEVEL% == 0 (
   type docfx.log
   ECHO Error: docfx build failed. 1>&2

docs/docfx.json

@@ -1,4 +1,21 @@
 {
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "src/**.csproj"
+          ],
+          "exclude": [
+            "**/bin/**",
+            "**/obj/**",
+            "_site/**"
+          ]
+        }
+      ],
+      "dest": "_api"
+    }
+  ],
   "build": {
     "content": [
       {