Update docfx, run as .NET tool instead of choco

Author: bkoelman

.config/dotnet-tools.json

@@ -25,6 +25,12 @@
       "commands": [
         "reportgenerator"
       ]
+    },
+    "docfx": {
+      "version": "2.60.2",
+      "commands": [
+        "docfx"
+      ]
     }
   }
 }

appveyor.yml

@@ -45,15 +45,11 @@ for:
             # https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
             git checkout $env:APPVEYOR_REPO_BRANCH -q
         }
-        choco install docfx -y
-        if ($lastexitcode -ne 0) {
-            throw "docfx install failed with exit code $lastexitcode."
-        }
   after_build:
     - pwsh: |
         CD ./docs
         & ./generate-examples.ps1
-        & docfx docfx.json
+        & dotnet docfx docfx.json
         if ($lastexitcode -ne 0) {
             throw "docfx build failed with exit code $lastexitcode."
         }

docs/README.md

@@ -3,11 +3,7 @@ Documentation for JsonApiDotNetCore is produced using [DocFX](https://dotnet.git
 In addition, the example request/response pairs are generated by executing `curl` commands against the GettingStarted project.
 
 # Installation
-Run the following commands once to setup your system:
-
-```
-choco install docfx -y
-```
+Run the following command once to setup your system:
 
 ```
 npm install -g httpserver

docs/build-dev.ps1

@@ -1,9 +1,8 @@
 #Requires -Version 7.0
 
 # This script builds the documentation website, starts a web server and opens the site in your browser. Intended for local development.
-# It is assumed that you have already installed docfx and httpserver.
-# If that's not the case, run the next commands:
-#   choco install docfx -y
+# It is assumed that you have already installed httpserver.
+# If that's not the case, run the next command:
 #   npm install -g httpserver
 
 param(
@@ -26,7 +25,7 @@ if (-Not $NoBuild -Or -Not (Test-Path -Path _site)) {
     Invoke-Expression ./generate-examples.ps1
 }
 
-docfx ./docfx.json
+dotnet docfx ./docfx.json
 VerifySuccessExitCode
 
 Copy-Item -Force home/*.html _site/