Update docfx sanity check (#2285)

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

.github/workflows/checks.yaml

@@ -70,17 +70,18 @@ jobs:
       run: make misspell
 
   docfx:
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
-    - name: check out code
-      uses: actions/checkout@v2
+    - uses: actions/checkout@v2
+    - uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: 6.0.x
 
     - name: install docfx
-      run: choco install docfx -y
+      run: dotnet tool update -g docfx --version "3.0.0-*" --add-source https://docfx.pkgs.visualstudio.com/docfx/_packaging/docs-public-packages/nuget/v3/index.json
 
-    - name: run .\docfx.cmd
-      shell: cmd
-      run: .\docfx.cmd
+    - name: run docfx
+      run: docfx build --dry-run
 
   semantic-conventions:
     runs-on: ubuntu-latest

docfx.json

@@ -1,29 +1,7 @@
 {
-  "build": {
-    "content": [
-      {
-        "files": [
-          "**.md",
-          "toc.yml"
-        ]
-      }
-    ],
-    "resource": [
-      {
-        "files": [
-          ".github/CODEOWNERS",
-          ".markdownlint.yaml",
-          ".vscode/settings.json",
-          "**.png"
-        ]
-      }
-    ],
-    "dest": "_site",
-    "globalMetadataFiles": [],
-    "fileMetadataFiles": [],
-    "noLangKeyword": false,
-    "keepFileLink": false,
-    "cleanupCacheHistory": true,
-    "disableGitFeatures": true
+  "files": "**/*.{md,png}",
+  "warningsAsErrors": true,
+  "rules": {
+    "link-out-of-scope": "off"
   }
 }

specification/metrics/supplementary-guidelines.md

@@ -102,7 +102,7 @@ to record the total number of bytes received:
 You can see that the total increment during (T<sub>0</sub>, T<sub>1</sub>] is
 `0`, the total increment during (T<sub>1</sub>, T<sub>2</sub>] is `280` (`30 +
 200 + 50`), the total increment during (T<sub>2</sub>, T<sub>3</sub>] is `100`,
-and the total increment during (T<s3ub>0</sub>, T<sub>3</sub>] is `380` (`0 +
+and the total increment during (T<sub>0</sub>, T<sub>3</sub>] is `380` (`0 +
 280 + 100`). All the increments are non-negative, in other words, the **sum is
 monotonically increasing**.