Csharp doc update (#37)

* update dest to csharp folder, update ci to remove unused files, update git ignore

* add test branch to ci

* remove yml, add api to git ignore, update windows CI to build docfx meta

* lower dotnet version

* fix docfx build to build from classes

* remove yml files before pr is created

* fix link on main page

* fix link to main csharp doc page

Co-authored-by: brev <46505951+cassiebreviu@users.noreply.github.com>

.github/workflows/publish-csharp-apidocs.yml

@@ -11,11 +11,29 @@ jobs:
     - name: Setup .NET
       uses: actions/setup-dotnet@v2
       with:
-        dotnet-version: 6.0.x
+        dotnet-version: 5.0.x
     - name: Restore dependencies
       run: dotnet restore csharp/ApiDocs/ApiDocs.csproj
-    - name: Build
-      run: dotnet build csharp/ApiDocs/ApiDocs.csproj --no-restore
+    - name: Download DocFX
+      run: |
+        mkdir build/docfx
+        Invoke-WebRequest -Uri "https://github.com/dotnet/docfx/releases/download/v${env:DOCFXVERSION}/docfx.zip" -OutFile "build/docfx/docfx.zip"
+        [System.IO.Compression.ZipFile]::ExtractToDirectory("build/docfx/docfx.zip", "build/docfx" )
+        cd build
+        cd docfx
+        ls
+      env:
+        DOCFXVERSION: 2.59.3
+
+    - name: Install NuGet
+      uses: nuget/setup-nuget@v1
+
+    - name: Build Documentation
+      run: |
+        ls
+        build/docfx/docfx.exe metadata csharp/ApiDocs/docfx.json
+        dotnet build csharp/ApiDocs/ApiDocs.csproj --no-restore
+        build/docfx/docfx.exe build csharp/ApiDocs/docfx.json
     - name: Set commit ID
       id: vars
       run: echo "::set-output name=sha_short::$(git rev-parse --short HEAD)"
@@ -25,10 +43,13 @@ jobs:
         clean: false
     - name: Move API docs into target area
       run: |
-        rm -rf docs/api/csharp
-        mv csharp/ApiDocs/csharp docs/api
-        rm -r csharp/ApiDocs
-        rm -r csharp/src
+        rm -r -fo docs/api/csharp
+        MOVE csharp/ApiDocs/csharp docs/api
+        rm -r -fo csharp/ApiDocs/obj
+        rm -r -fo csharp/ApiDocs/bin
+        rm -r -fo csharp/ApiDocs/api/*.yml
+        rm -r -fo csharp/ApiDocs/log.txt
+        rm -r -fo csharp/src
     - name: Git Checkin
       run: git add .
     - name: Create Pull Request

csharp/ApiDocs/.gitignore

@@ -6,7 +6,5 @@
 /**/packages/
 /**/bin/
 /**/obj/
-_site
-dest
 csharp
 *.txt

csharp/ApiDocs/api/.gitignore

@@ -1,4 +1,5 @@
 ###############
 #  temp file  #
 ###############
+*.yml
 .manifest